org.apache.brooklyn.util.text

Class Strings

java.lang.Object

org.apache.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 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()

Method Summary

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	containsAny(java.lang.CharSequence input, java.lang.CharSequence... candidates)
static boolean	containsLiteral(java.lang.CharSequence input, java.lang.CharSequence fragment)
static boolean	containsLiteralIgnoreCase(java.lang.CharSequence input, java.lang.CharSequence fragment)
static int	countOccurrences(java.lang.String phrase, char target)
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 <any>	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.Iterable<java.lang.String> lines) convenience for joining lines together
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.util.List<java.lang.String>	parseCsv(java.lang.String csv)
static java.util.List<java.lang.String>	parseCsv(java.lang.String csv, java.lang.String separatorRegex) Parses a string as comma separated values and returns a list of the entries with whitespace removed.
static java.lang.String	removeAfter(java.lang.String string, java.lang.String marker, boolean includeMarker) Removes everything after the marker, optionally also removing the marker.
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	removeBefore(java.lang.String string, java.lang.String marker, boolean includeMarker) Removes everything before the marker, optionally also removing the marker.
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 prefix) Removes prefix from the beginning of string.
static java.lang.String	removeLines(java.lang.String multiline, <any> patternToRemove)
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 readability, 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.List<java.lang.String>	toStringList(java.lang.Object v) Tries to convert v to a list of strings.
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 <any>	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 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.

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.

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.

removeAfter

public static java.lang.String removeAfter(java.lang.String string,
                                           java.lang.String marker,
                                           boolean includeMarker)

Removes everything after the marker, optionally also removing the marker. If marker not found the string is unchanged.

removeBefore

public static java.lang.String removeBefore(java.lang.String string,
                                            java.lang.String marker,
                                            boolean includeMarker)

Removes everything before the marker, optionally also removing the marker. If marker not found the string is unchanged.

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

lines

public static java.lang.String lines(java.lang.Iterable<java.lang.String> lines)

convenience for joining lines together

removeLines

public static java.lang.String removeLines(java.lang.String multiline,
                                           <any> patternToRemove)

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 readability, 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)

containsAny

public static boolean containsAny(java.lang.CharSequence input,
                                  java.lang.CharSequence... candidates)

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 <any> 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

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

toStringList

public static java.util.List<java.lang.String> toStringList(java.lang.Object v)

Tries to convert v to a list of strings.

If v is null then the method returns an empty immutable list. If v is Iterable or an Object[] then toString is called on its elements. If v is a String then a singleton list containing v is returned. Otherwise the method throws an IllegalArgumentException.

repeat

public static java.lang.String repeat(java.lang.String base,
                                      int count)

returns base repeated count times

lengthComparator

public static <any> 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)

parseCsv

public static java.util.List<java.lang.String> parseCsv(java.lang.String csv,
                                                        java.lang.String separatorRegex)

Parses a string as comma separated values and returns a list of the entries with whitespace removed.

Parameters:

csv - The "comma" separated values.

separatorRegex - Regex of separatorRegex.

parseCsv

public static java.util.List<java.lang.String> parseCsv(java.lang.String csv)

countOccurrences

public static int countOccurrences(java.lang.String phrase,
                                   char target)