Strings (Apache Brooklyn)

java.lang.Object
- brooklyn.util.text.Strings

public class Strings
extends java.lang.Object

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`EMPTY` The empty `String`.
`static com.google.common.base.CharMatcher`	`IS_JAVA_IDENTIFIER_PART` A `CharMatcher` that matches valid Java identifier characters.
`static java.lang.String`	`VALID_NON_ALPHANUM_FILE_CHARS` Valid non alphanumeric characters for filenames.

Constructor Summary

Constructors
Constructor and Description

Strings()

Constructors
Constructor and Description
`Strings()`

Method Summary

Methods
Modifier and Type	Method and Description
`static void`	`checkNonEmpty(java.lang.CharSequence s)` throws IllegalArgument if string not empty; cf.
`static void`	`checkNonEmpty(java.lang.CharSequence s, java.lang.String message)` throws IllegalArgument if string not empty; cf.
`static java.lang.String`	`collapseWhitespace(java.lang.String x, java.lang.String whitespaceReplacement)` replaces each sequence of whitespace in the first string with the replacement in the second string
`static java.lang.String[]`	`combineArrays(java.lang.String[]... arrays)`
`static boolean`	`containsLiteral(java.lang.CharSequence input, java.lang.CharSequence fragment)`
`static boolean`	`containsLiteralIgnoreCase(java.lang.CharSequence input, java.lang.CharSequence fragment)`
`static java.lang.String`	`emptyToNull(java.lang.String var)`
`static FormattedString`	`format(java.lang.String pattern, java.lang.Object... args)` wraps a call to `String.format(String, Object...)` in a toString, i.e.
`static char`	`getDecimalSeparator(java.util.Locale locale)`
`static char`	`getDefaultDecimalSeparator()`
`static java.lang.String`	`getFirstLine(java.lang.String s)`
`static java.lang.String`	`getFirstWord(java.lang.String s)` returns the first word (whitespace delimited text), or null if there is none (input null or all whitespace)
`static java.lang.String`	`getFirstWordAfter(java.lang.String context, java.lang.String phrase)` returns the first word after the given phrase, or null if no such phrase; if the character immediately after the phrase is not whitespace, the non-whitespace sequence starting with that character will be returned
`static java.lang.String`	`getFragmentBetween(java.lang.String input, java.lang.String prefix, java.lang.String suffix)` looks for first section of text in following the prefix and, if present, before the suffix; null if the prefix is not present in the string, and everything after the prefix if suffix is not present in the string; if either prefix or suffix is null, it is treated as the start/end of the string
`static java.lang.String`	`getLastWord(java.lang.String s)` returns the last word (whitespace delimited text), or null if there is none (input null or all whitespace)
`static java.lang.String`	`getRemainderOfLineAfter(java.lang.String context, java.lang.String phrase)` searches in context for the given phrase, and returns the untrimmed remainder of the first line on which the phrase is found
`static int`	`getWordCount(java.lang.String phrase, boolean respectQuotes)`
`static java.lang.String`	`ies(int count)` returns "ies" if the argument is not 1, "y" otherwise; useful when constructing plurals
`static java.lang.String`	`ies(java.lang.Iterable<?> x)` as `ies(int)` based on size of argument
`static java.lang.String`	`ies(java.util.Iterator<?> x)` as `ies(int)` based on size of argument
`static java.lang.String`	`ies(java.util.Map<?,?> x)` as `ies(int)` based on size of argument
`static boolean`	`isBlank(java.lang.CharSequence s)` Checks if the given string is empty or only consists of whitespace.
`static boolean`	`isEmpty(java.lang.CharSequence s)` Checks if the given string is null or is an empty string.
`static boolean`	`isLowerCase(java.lang.String s)`
`static boolean`	`isMultiLine(java.lang.String s)`
`static boolean`	`isNonBlank(java.lang.CharSequence s)` The inverse of `isBlank(CharSequence)`.
`static boolean`	`isNonEmpty(java.lang.CharSequence s)` The inverse of `isEmpty(CharSequence)`.
`static java.lang.String`	`join(java.lang.Iterable<? extends java.lang.Object> list, java.lang.String separator)` convenience for `Joiner`
`static java.lang.String`	`join(java.lang.Object[] list, java.lang.String separator)` convenience for `Joiner`
`static com.google.common.collect.Ordering<java.lang.String>`	`lengthComparator()` returns comparator which compares based on length, with shorter ones first (and null before that); in event of a tie, it uses the toString order
`static java.lang.String`	`lines(java.lang.String... lines)` convenience for joining lines together
`static java.lang.String[]`	`makeArray(java.lang.String prefix, int count)` returns e.g.
`static java.lang.String`	`makeISOSizeString(long sizeInBytes)` Returns a size string using ISO suffixes from `ByteSizeStrings.iso()`, e.g.
`static java.lang.String`	`makeJavaSizeString(long sizeInBytes)` Returns a size string using Java suffixes from `ByteSizeStrings.java()`, e.g.
`static java.lang.String`	`makePaddedString(java.lang.String base, int len, java.lang.String left_pad, java.lang.String right_pad)` pads the string with "pad" at the left up to len; no padding if base longer than len
`static java.lang.String`	`makeRandomId(int l)`
`static java.lang.String`	`makeRealString(double x, int maxlen, int prec, int leftPadLen)` creates a string from a real number, with specified accuracy (more iff it comes for free, ie integer-part); switches to E notation if needed to fit within maxlen; can be padded left up too (not useful)
`static java.lang.String`	`makeRealString(double x, int maxlen, int prec, int leftPadLen, double skipDecimalThreshhold, boolean useEForSmallNumbers)` creates a string from a real number, with specified accuracy (more iff it comes for free, ie integer-part); switches to E notation if needed to fit within maxlen; can be padded left up too (not useful)
`static java.lang.String`	`makeRealStringNearZero(double x, int maxlen, int prec, int leftPadLen)` creates a string from a real number, with specified accuracy (more iff it comes for free, ie integer-part); switches to E notation if needed to fit within maxlen; can be padded left up too (not useful)
`static java.lang.String`	`makeRepeated(char c, int length)`
`static java.lang.String`	`makeSizeString(long sizeInBytes)` Returns a size string using metric suffixes from `ByteSizeStrings.metric()`, e.g.
`static java.lang.String`	`makeTimeString(long utcMillis)` Deprecated. use `Time.makeTimeStringRounded(long)`
`static java.lang.String`	`makeValidFilename(java.lang.String s)` Returns a valid filename based on the input.
`static java.lang.String`	`makeValidJavaName(java.lang.String s)` Returns a valid Java identifier name based on the input.
`static java.lang.String`	`makeValidUniqueJavaName(java.lang.String s)` Returns a unique valid java identifier name based on the input.
`static java.lang.String`	`makeZeroPaddedString(int i, int len)` pads the string with 0's at the left up to len; no padding if i longer than len
`static java.lang.String`	`maxlen(java.lang.String s, int maxlen)` returns up to maxlen characters from the start of s
`static java.lang.String`	`maxlenWithEllipsis(java.lang.String s, int maxlen)` as {@link #maxlenWithEllipsis(String, int, String) with "..." as the ellipsis
`static java.lang.String`	`maxlenWithEllipsis(java.lang.String s, int maxlen, java.lang.String ellipsis)` as {@link #maxlenWithEllipsis(String, int) but replacing the last few chars with the given ellipsis
`static <T extends java.lang.CharSequence> Maybe<T>`	`maybeNonBlank(T s)`
`static java.lang.String`	`removeAllFromEnd(java.lang.String string, java.lang.String... suffixes)` As removeFromEnd, but repeats until all such suffixes are gone
`static java.lang.String`	`removeAllFromStart(java.lang.String string, java.lang.String... prefixes)` As `removeFromStart(String, String)`, repeating until all such prefixes are gone.
`static java.lang.String`	`removeFromEnd(java.lang.String string, java.lang.String... suffixes)` Deprecated. since 0.7.0 use `removeFromEnd(String, String)` or `removeAllFromEnd(String, String...)`
`static java.lang.String`	`removeFromEnd(java.lang.String string, java.lang.String suffix)` Removes suffix from the end of the string.
`static java.lang.String`	`removeFromStart(java.lang.String string, java.lang.String... prefixes)` Deprecated. since 0.7.0 use `removeFromStart(String, String)`
`static java.lang.String`	`removeFromStart(java.lang.String string, java.lang.String prefix)` Removes prefix from the beginning of string.
`static java.lang.String`	`repeat(java.lang.String base, int count)` returns base repeated count times
`static java.lang.String`	`replaceAll(java.lang.String source, java.util.Map replacements)` NON-REGEX - replaces all key->value entries from the replacement map in source (non-regex)
`static java.lang.String`	`replaceAll(java.lang.String source, java.lang.String pattern, java.lang.String replacement)` NON-REGEX replaceAll - see the better, explicitly named `replaceAllNonRegex(String, String, String)`.
`static java.lang.String`	`replaceAllNonRegex(java.lang.String source, java.lang.String pattern, java.lang.String replacement)` Replaces all instances in source, of the given pattern, with the given replacement (not interpreting any arguments as regular expressions).
`static java.lang.String`	`replaceAllRegex(java.lang.String source, java.lang.String pattern, java.lang.String replacement)` REGEX replacement -- explicit method name for reabaility, doing same as `String.replaceAll(String, String)`.
`static java.lang.String`	`reverse(java.lang.String name)`
`static java.lang.String`	`s(int count)` returns "s" if the argument is not 1, empty string otherwise; useful when constructing plurals
`static java.lang.String`	`s(java.lang.Iterable<?> x)` as `s(int)` based on size of argument
`static java.lang.String`	`s(java.util.Iterator<?> x)` as `s(int)` based on size of argument
`static java.lang.String`	`s(java.util.Map<?,?> x)` as `s(int)` based on size of argument
`static StringShortener`	`shortener()` returns a configurable shortener
`static java.lang.String`	`toInitialCapOnly(java.lang.String value)`
`static java.lang.String`	`toLowerCase(java.lang.String value)`
`static java.lang.String`	`toString(java.lang.Object o)` returns toString of the object if it is not null, otherwise null
`static java.util.List<java.lang.String>`	`toStringList(java.util.List<?> list, java.lang.String valueIfNull)` converts a list of any objects to a list of strings, using `Object.toString()`, with the second argument used where an entry is null
`static java.util.Map<java.lang.String,java.lang.String>`	`toStringMap(java.util.Map<?,?> map)` Deprecated. since 0.7.0 use `toStringMap(Map, String)` to remove ambiguity about how to handle null
`static java.util.Map<java.lang.String,java.lang.String>`	`toStringMap(java.util.Map<?,?> map, java.lang.String valueIfNull)` converts a map of any objects to a map of strings, using `Object.toString()`, with the second argument used where a value (or key) is null
`static com.google.common.base.Supplier<java.lang.String>`	`toStringSupplier(java.lang.Object src)`
`static java.lang.String`	`toStringWithValueForNull(java.lang.Object o, java.lang.String valueIfNull)` returns toString of the object if it is not null, otherwise the given value
`static java.lang.String`	`toUniqueString(java.lang.Object x, int optionalMax)` Returns canonicalized string from the given object, made "unique" by: putting sets into the toString order appending a hash code if it's longer than the max (and the max is bigger than 0)
`static java.lang.String`	`trim(java.lang.String s)`
`static void`	`trimAll(java.lang.String[] s)`
`static java.lang.String`	`trimEnd(java.lang.String s)`

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EMPTY
```
public static final java.lang.String EMPTY
```
    The empty String.
    
    See Also:
    Constant Field Values
  - VALID_NON_ALPHANUM_FILE_CHARS
```
public static final java.lang.String VALID_NON_ALPHANUM_FILE_CHARS
```
    Valid non alphanumeric characters for filenames.
    
    See Also:
    Constant Field Values
  - IS_JAVA_IDENTIFIER_PART
```
public static final com.google.common.base.CharMatcher IS_JAVA_IDENTIFIER_PART
```
    A CharMatcher that matches valid Java identifier characters.
    
    See Also:
    Character.isJavaIdentifierPart(char)
- Constructor Detail
  - Strings
```
public Strings()
```
- Method Detail
  - isEmpty
```
public static boolean isEmpty(java.lang.CharSequence s)
```
    Checks if the given string is null or is an empty string. Useful for pre-String.isEmpty. And useful for StringBuilder etc.
    
    Parameters:
    s - the String to check
    
    Returns:
    true if empty or null, false otherwise.
    See Also:
    isNonEmpty(CharSequence), isBlank(CharSequence), isNonBlank(CharSequence)
  - isBlank
```
public static boolean isBlank(java.lang.CharSequence s)
```
    Checks if the given string is empty or only consists of whitespace.
    
    Parameters:
    s - the String to check
    
    Returns:
    true if blank, empty or null, false otherwise.
    See Also:
    isEmpty(CharSequence), isNonEmpty(CharSequence), isNonBlank(CharSequence)
  - isNonEmpty
```
public static boolean isNonEmpty(java.lang.CharSequence s)
```
    The inverse of isEmpty(CharSequence).
    
    Parameters:
    s - the String to check
    
    Returns:
    true if non empty, false otherwise.
    See Also:
    isEmpty(CharSequence), isBlank(CharSequence), isNonBlank(CharSequence)
  - isNonBlank
```
public static boolean isNonBlank(java.lang.CharSequence s)
```
    The inverse of isBlank(CharSequence).
    
    Parameters:
    s - the String to check
    
    Returns:
    true if non blank, false otherwise.
    See Also:
    isEmpty(CharSequence), isNonEmpty(CharSequence), isBlank(CharSequence)
  - maybeNonBlank
```
public static <T extends java.lang.CharSequence> Maybe<T> maybeNonBlank(T s)
```
    Returns:
    a Maybe object which is absent if the argument isBlank(CharSequence)
  - checkNonEmpty
```
public static void checkNonEmpty(java.lang.CharSequence s)
```
    throws IllegalArgument if string not empty; cf. guava Preconditions.checkXxxx
  - checkNonEmpty
```
public static void checkNonEmpty(java.lang.CharSequence s,
                 java.lang.String message)
```
    throws IllegalArgument if string not empty; cf. guava Preconditions.checkXxxx
  - removeFromEnd
```
public static java.lang.String removeFromEnd(java.lang.String string,
                             java.lang.String suffix)
```
    Removes suffix from the end of the string. Returns string if it does not end with suffix.
  - removeFromEnd
```
@Deprecated
public static java.lang.String removeFromEnd(java.lang.String string,
                                        java.lang.String... suffixes)
```
    Deprecated. since 0.7.0 use removeFromEnd(String, String) or removeAllFromEnd(String, String...)
    
    removes the first suffix in the list which is present at the end of string and returns that string; ignores subsequent suffixes if a matching one is found; returns the original string if no suffixes are at the end
  - removeAllFromEnd
```
public static java.lang.String removeAllFromEnd(java.lang.String string,
                                java.lang.String... suffixes)
```
    As removeFromEnd, but repeats until all such suffixes are gone
  - removeFromStart
```
public static java.lang.String removeFromStart(java.lang.String string,
                               java.lang.String prefix)
```
    Removes prefix from the beginning of string. Returns string if it does not begin with prefix.
  - removeFromStart
```
@Deprecated
public static java.lang.String removeFromStart(java.lang.String string,
                                          java.lang.String... prefixes)
```
    Deprecated. since 0.7.0 use removeFromStart(String, String)
    
    removes the first prefix in the list which is present at the start of string and returns that string; ignores subsequent prefixes if a matching one is found; returns the original string if no prefixes match
  - removeAllFromStart
```
public static java.lang.String removeAllFromStart(java.lang.String string,
                                  java.lang.String... prefixes)
```
    As removeFromStart(String, String), repeating until all such prefixes are gone.
  - join
```
public static java.lang.String join(java.lang.Iterable<? extends java.lang.Object> list,
                    java.lang.String separator)
```
    convenience for Joiner
  - join
```
public static java.lang.String join(java.lang.Object[] list,
                    java.lang.String separator)
```
    convenience for Joiner
  - lines
```
public static java.lang.String lines(java.lang.String... lines)
```
    convenience for joining lines together
  - replaceAll
```
public static java.lang.String replaceAll(java.lang.String source,
                          java.util.Map replacements)
```
    NON-REGEX - replaces all key->value entries from the replacement map in source (non-regex)
  - replaceAll
```
public static java.lang.String replaceAll(java.lang.String source,
                          java.lang.String pattern,
                          java.lang.String replacement)
```
    NON-REGEX replaceAll - see the better, explicitly named replaceAllNonRegex(String, String, String).
  - replaceAllNonRegex
```
public static java.lang.String replaceAllNonRegex(java.lang.String source,
                                  java.lang.String pattern,
                                  java.lang.String replacement)
```
    Replaces all instances in source, of the given pattern, with the given replacement (not interpreting any arguments as regular expressions).
    This is actually the same as the very ambiguous String.replace(CharSequence, CharSequence), which does replace all, but not using regex like the similarly ambiguous String.replaceAll(String, String) as. Alternatively see replaceAllRegex(String, String, String).
  - replaceAllRegex
```
public static java.lang.String replaceAllRegex(java.lang.String source,
                               java.lang.String pattern,
                               java.lang.String replacement)
```
    REGEX replacement -- explicit method name for reabaility, doing same as String.replaceAll(String, String).
  - makeValidFilename
```
public static java.lang.String makeValidFilename(java.lang.String s)
```
    Returns a valid filename based on the input. A valid filename starts with the first alphanumeric character, then include all alphanumeric characters plus those in VALID_NON_ALPHANUM_FILE_CHARS, with any runs of invalid characters being replaced by _.
    
    Throws:
    
    java.lang.NullPointerException - if the input string is null.
    
    java.lang.IllegalArgumentException - if the input string is blank.
  - makeValidJavaName
```
public static java.lang.String makeValidJavaName(java.lang.String s)
```
    Returns a valid Java identifier name based on the input. Removes certain characterss (like apostrophe), replaces one or more invalid characterss with _, and prepends _ if the first character is only valid as an identifier part (not start).
    The result is usually unique to s, though this isn't guaranteed, for example if all characters are invalid. For a unique identifier use makeValidUniqueJavaName(String).
    
    See Also:
    makeValidUniqueJavaName(String)
  - makeValidUniqueJavaName
```
public static java.lang.String makeValidUniqueJavaName(java.lang.String s)
```
    Returns a unique valid java identifier name based on the input. Translated as per makeValidJavaName(String) but with String.hashCode() appended where necessary to guarantee uniqueness.
    
    See Also:
    makeValidJavaName(String)
  - makeRandomId
```
public static java.lang.String makeRandomId(int l)
```
    See Also:
    Identifiers#makeRandomId(int)}
  - makeZeroPaddedString
```
public static java.lang.String makeZeroPaddedString(int i,
                                    int len)
```
    pads the string with 0's at the left up to len; no padding if i longer than len
  - makePaddedString
```
public static java.lang.String makePaddedString(java.lang.String base,
                                int len,
                                java.lang.String left_pad,
                                java.lang.String right_pad)
```
    pads the string with "pad" at the left up to len; no padding if base longer than len
  - trimAll
```
public static void trimAll(java.lang.String[] s)
```
  - makeRealString
```
public static java.lang.String makeRealString(double x,
                              int maxlen,
                              int prec,
                              int leftPadLen)
```
    creates a string from a real number, with specified accuracy (more iff it comes for free, ie integer-part); switches to E notation if needed to fit within maxlen; can be padded left up too (not useful)
    
    Parameters:
    x - number to use
    maxlen - maximum length for the numeric string, if possible (-1 to suppress)
    prec - number of digits accuracy desired (more kept for integers)
    leftPadLen - will add spaces at left if necessary to make string this long (-1 to suppress) [probably not usef]
    
    Returns:
    such a string
  - makeRealString
```
public static java.lang.String makeRealString(double x,
                              int maxlen,
                              int prec,
                              int leftPadLen,
                              double skipDecimalThreshhold,
                              boolean useEForSmallNumbers)
```
    creates a string from a real number, with specified accuracy (more iff it comes for free, ie integer-part); switches to E notation if needed to fit within maxlen; can be padded left up too (not useful)
    
    Parameters:
    x - number to use
    maxlen - maximum length for the numeric string, if possible (-1 to suppress)
    prec - number of digits accuracy desired (more kept for integers)
    leftPadLen - will add spaces at left if necessary to make string this long (-1 to suppress) [probably not usef]
    skipDecimalThreshhold - if positive it will not add a decimal part if the fractional part is less than this threshhold (but for a value 3.00001 it would show zeroes, e.g. with 3 precision and positive threshhold <= 0.00001 it would show 3.00); if zero or negative then decimal digits are always shown
    useEForSmallNumbers - whether to use E notation for numbers near zero (e.g. 0.001)
    
    Returns:
    such a string
  - makeRealStringNearZero
```
public static java.lang.String makeRealStringNearZero(double x,
                                      int maxlen,
                                      int prec,
                                      int leftPadLen)
```
    creates a string from a real number, with specified accuracy (more iff it comes for free, ie integer-part); switches to E notation if needed to fit within maxlen; can be padded left up too (not useful)
    
    Parameters:
    x - number to use
    maxlen - maximum length for the numeric string, if possible (-1 to suppress)
    prec - number of digits accuracy desired (more kept for integers)
    leftPadLen - will add spaces at left if necessary to make string this long (-1 to suppress) [probably not usef]
    
    Returns:
    such a string
  - getFirstWord
```
public static java.lang.String getFirstWord(java.lang.String s)
```
    returns the first word (whitespace delimited text), or null if there is none (input null or all whitespace)
  - getLastWord
```
public static java.lang.String getLastWord(java.lang.String s)
```
    returns the last word (whitespace delimited text), or null if there is none (input null or all whitespace)
  - getFirstWordAfter
```
public static java.lang.String getFirstWordAfter(java.lang.String context,
                                 java.lang.String phrase)
```
    returns the first word after the given phrase, or null if no such phrase; if the character immediately after the phrase is not whitespace, the non-whitespace sequence starting with that character will be returned
  - getRemainderOfLineAfter
```
public static java.lang.String getRemainderOfLineAfter(java.lang.String context,
                                       java.lang.String phrase)
```
    searches in context for the given phrase, and returns the untrimmed remainder of the first line on which the phrase is found
  - makeTimeString
```
@Deprecated
public static java.lang.String makeTimeString(long utcMillis)
```
    Deprecated. use Time.makeTimeStringRounded(long)
  - makeArray
```
public static java.lang.String[] makeArray(java.lang.String prefix,
                           int count)
```
    returns e.g. { "prefix01", ..., "prefix96" }; see more functional NumericRangeGlobExpander for "prefix{01-96}"
  - combineArrays
```
public static java.lang.String[] combineArrays(java.lang.String[]... arrays)
```
  - toInitialCapOnly
```
public static java.lang.String toInitialCapOnly(java.lang.String value)
```
  - reverse
```
public static java.lang.String reverse(java.lang.String name)
```
  - isLowerCase
```
public static boolean isLowerCase(java.lang.String s)
```
  - makeRepeated
```
public static java.lang.String makeRepeated(char c,
                            int length)
```
  - trim
```
public static java.lang.String trim(java.lang.String s)
```
  - trimEnd
```
public static java.lang.String trimEnd(java.lang.String s)
```
  - maxlen
```
public static java.lang.String maxlen(java.lang.String s,
                      int maxlen)
```
    returns up to maxlen characters from the start of s
  - maxlenWithEllipsis
```
public static java.lang.String maxlenWithEllipsis(java.lang.String s,
                                  int maxlen)
```
    as {@link #maxlenWithEllipsis(String, int, String) with "..." as the ellipsis
  - maxlenWithEllipsis
```
public static java.lang.String maxlenWithEllipsis(java.lang.String s,
                                  int maxlen,
                                  java.lang.String ellipsis)
```
    as {@link #maxlenWithEllipsis(String, int) but replacing the last few chars with the given ellipsis
  - toString
```
public static java.lang.String toString(java.lang.Object o)
```
    returns toString of the object if it is not null, otherwise null
  - toStringWithValueForNull
```
public static java.lang.String toStringWithValueForNull(java.lang.Object o,
                                        java.lang.String valueIfNull)
```
    returns toString of the object if it is not null, otherwise the given value
  - containsLiteralIgnoreCase
```
public static boolean containsLiteralIgnoreCase(java.lang.CharSequence input,
                                java.lang.CharSequence fragment)
```
  - containsLiteral
```
public static boolean containsLiteral(java.lang.CharSequence input,
                      java.lang.CharSequence fragment)
```
  - makeSizeString
```
public static java.lang.String makeSizeString(long sizeInBytes)
```
    Returns a size string using metric suffixes from ByteSizeStrings.metric(), e.g. 23.5MB
  - makeISOSizeString
```
public static java.lang.String makeISOSizeString(long sizeInBytes)
```
    Returns a size string using ISO suffixes from ByteSizeStrings.iso(), e.g. 23.5MiB
  - makeJavaSizeString
```
public static java.lang.String makeJavaSizeString(long sizeInBytes)
```
    Returns a size string using Java suffixes from ByteSizeStrings.java(), e.g. 23m
  - shortener
```
public static StringShortener shortener()
```
    returns a configurable shortener
  - toStringSupplier
```
public static com.google.common.base.Supplier<java.lang.String> toStringSupplier(java.lang.Object src)
```
  - format
```
public static FormattedString format(java.lang.String pattern,
                     java.lang.Object... args)
```
    wraps a call to String.format(String, Object...) in a toString, i.e. using %s syntax, useful for places where we want deferred evaluation (e.g. as message to Preconditions to skip concatenation when not needed)
  - s
```
public static java.lang.String s(int count)
```
    returns "s" if the argument is not 1, empty string otherwise; useful when constructing plurals
  - s
```
public static java.lang.String s(@Nullable
                 java.util.Map<?,?> x)
```
    as s(int) based on size of argument
  - s
```
public static java.lang.String s(java.lang.Iterable<?> x)
```
    as s(int) based on size of argument
  - s
```
public static java.lang.String s(java.util.Iterator<?> x)
```
    as s(int) based on size of argument
  - ies
```
public static java.lang.String ies(int count)
```
    returns "ies" if the argument is not 1, "y" otherwise; useful when constructing plurals
  - ies
```
public static java.lang.String ies(@Nullable
                   java.util.Map<?,?> x)
```
    as ies(int) based on size of argument
  - ies
```
public static java.lang.String ies(java.lang.Iterable<?> x)
```
    as ies(int) based on size of argument
  - ies
```
public static java.lang.String ies(java.util.Iterator<?> x)
```
    as ies(int) based on size of argument
  - toStringMap
```
@Deprecated
public static java.util.Map<java.lang.String,java.lang.String> toStringMap(java.util.Map<?,?> map)
```
    Deprecated. since 0.7.0 use toStringMap(Map, String) to remove ambiguity about how to handle null
    
    converts a map of any objects to a map of strings, using the tostring, and returning "null" for nulls
  - toStringMap
```
public static java.util.Map<java.lang.String,java.lang.String> toStringMap(java.util.Map<?,?> map,
                                                           java.lang.String valueIfNull)
```
    converts a map of any objects to a map of strings, using Object.toString(), with the second argument used where a value (or key) is null
  - toStringList
```
public static java.util.List<java.lang.String> toStringList(java.util.List<?> list,
                                            java.lang.String valueIfNull)
```
    converts a list of any objects to a list of strings, using Object.toString(), with the second argument used where an entry is null
  - repeat
```
public static java.lang.String repeat(java.lang.String base,
                      int count)
```
    returns base repeated count times
  - lengthComparator
```
public static com.google.common.collect.Ordering<java.lang.String> lengthComparator()
```
    returns comparator which compares based on length, with shorter ones first (and null before that); in event of a tie, it uses the toString order
  - isMultiLine
```
public static boolean isMultiLine(java.lang.String s)
```
  - getFirstLine
```
public static java.lang.String getFirstLine(java.lang.String s)
```
  - getFragmentBetween
```
public static java.lang.String getFragmentBetween(java.lang.String input,
                                  java.lang.String prefix,
                                  java.lang.String suffix)
```
    looks for first section of text in following the prefix and, if present, before the suffix; null if the prefix is not present in the string, and everything after the prefix if suffix is not present in the string; if either prefix or suffix is null, it is treated as the start/end of the string
  - getWordCount
```
public static int getWordCount(java.lang.String phrase,
               boolean respectQuotes)
```
  - getDecimalSeparator
```
public static char getDecimalSeparator(java.util.Locale locale)
```
  - getDefaultDecimalSeparator
```
public static char getDefaultDecimalSeparator()
```
  - collapseWhitespace
```
public static java.lang.String collapseWhitespace(java.lang.String x,
                                  java.lang.String whitespaceReplacement)
```
    replaces each sequence of whitespace in the first string with the replacement in the second string
  - toLowerCase
```
public static java.lang.String toLowerCase(java.lang.String value)
```
  - emptyToNull
```
public static java.lang.String emptyToNull(java.lang.String var)
```
    Returns:
    null if var is null or empty string, otherwise return var
  - toUniqueString
```
public static java.lang.String toUniqueString(java.lang.Object x,
                              int optionalMax)
```
    Returns canonicalized string from the given object, made "unique" by:
  - putting sets into the toString order
  - appending a hash code if it's longer than the max (and the max is bigger than 0)

Class Strings

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY

VALID_NON_ALPHANUM_FILE_CHARS

IS_JAVA_IDENTIFIER_PART

Constructor Detail

Strings

Method Detail

isEmpty

isBlank

isNonEmpty

isNonBlank

maybeNonBlank

checkNonEmpty

checkNonEmpty

removeFromEnd

removeFromEnd

removeAllFromEnd

removeFromStart

removeFromStart

removeAllFromStart

join

join

lines

replaceAll

replaceAll

replaceAllNonRegex

replaceAllRegex

makeValidFilename

makeValidJavaName

makeValidUniqueJavaName

makeRandomId

makeZeroPaddedString

makePaddedString

trimAll

makeRealString

makeRealString

makeRealStringNearZero

getFirstWord

getLastWord

getFirstWordAfter

getRemainderOfLineAfter

makeTimeString

makeArray

combineArrays

toInitialCapOnly

reverse

isLowerCase

makeRepeated

trim

trimEnd

maxlen

maxlenWithEllipsis

maxlenWithEllipsis

toString

toStringWithValueForNull

containsLiteralIgnoreCase

containsLiteral

makeSizeString

makeISOSizeString

makeJavaSizeString

shortener

toStringSupplier

format

s

s

s

s

ies

ies

ies

ies

toStringMap

toStringMap

toStringList

repeat