Strings

Line-separator for *this* platform.

Convert a camel-case string to a sentence. Example:

 ThisIsACamelCaseString    -> This is a camel case string
 ThisIsACamel44CaseString  -> This is a camel44 case string
 CountryUSA                -> Country u s a
 
 with breakOnDigits=true:
 ThisIsACamel44CaseString  -> This is a camel 44 case string
 
 with keepUppercaseAcronyms=true:
 CountryUSA                -> Country USA
 

Convert a camel-case string to a sentence. Example:

 ThisIsACamelCaseString -> This is a camel case string
 

Capitalize the first character of a string.

A many-element variant of String.contains.

Indicates if a String s contains a particular substring at a specified index. Semantically equivalent to s.substring(i).startsWith(elt) without intermediate substring creation.

Count the number of occurrences of a sub-string within a string.

Note: a search for 'aaa' inside 'aaaaaa' would return 4, not 2!

Count the number of occurrences of a character within a string.

Count the number of non blank characters in the provided string.

Decode a byte buffer using an ASCII decoder. If the decoder is not available, the byte buffer is decoded using the system's default decoder.

Decode a byte buffer using an ASCII decoder. If the decoder is not available, the byte buffer is decoded using the system's default decoder.

Decode an encoded array of objects.

Decode an encoded list of objects.

Decode a byte buffer using the local platform's default charset. This method is potentially dangerous.

Decode a byte buffer using the local platform's default charset. This method is potentially dangerous.

Decode an encoded map.

Decode a byte buffer using a UTF-8 decoder. If the decoder is not available, the byte buffer is decoded using the system's default decoder.

Decode a byte buffer using a UTF-8 decoder. If the decoder is not available, the byte buffer is decoded using the system's default decoder.

Heuristically determine the encoding of a string.

Encode a string using an ASCII encoder. If the encoder is not available, the string is encoded using the system's default encoder. This should never happen.

Encode an array of objects.

Generate a byte array consisting of the low-bytes of the input string characters.

Encode a list of objects.

Encode a string using the local platform's default charset. This method is potentially dangerous.

Encode a dictionary. The encoding scheme will produce strings like: encodedKey1=encodedValue1&encodedKey2=encodedValue2&...

Encode a string using a UTF-8 encoder. If the encoder is not available, the string is encoded using the system's default encoder. This should never happen.

A many-element variant of String.endsWith.

A safer version of equals(Object).

A safer version of equalsIgnoreCase(String)

Format using the US locale.

A faster version of String#format(String, Object...).

A faster version of String#format(String, Object...).

A faster version of String#format(String, Object...).

A faster version of String#format(String, Object...).

Find a word in the string

Find a word in the string

Generate a repeated string.

Generate a repeated-character String. For CharSequence generation, use pad(char, int).

Same as getAsciiLength(data, data.length).

Retrieve the length of a potentially ASCII-encoded string. The String characters allowed are contained CR, LF, TAB, and any character in the [0x20, 0x7E] range.

Retrieve the size taken by the BOM or equivalent encoding mark. Detect UTF-8, UTF-16 and UTF-32.

Get a case-sensitive string comparator that treats hexadecimal sequences as numbers, and orders them accordingly, instead as simple strings.

Refer to NumberComparator and AlphanumCharComparator for details.

Get a string comparator that can treat hexadecimal sequences as numbers (and order them accordingly) instead as simple strings.

Refer to NumberComparator and AlphanumCharComparator for details.

Retrieve the initial blank bytes at the beginning of a stream (non data)

Determine if a string contains one or more WSP characters.

Determine if a string is non-null and non-empty.

Determine if a string contains right-to-left (RTL) characters, eg Arabic or Hebrew characters.

Indent a buffer using a 4-space indentation.

Indent a buffer.

Implementation of indexOf for CharSequence. Same behavior as indexOf(int).

Find the first one of two characters and return its position.

Find the first one of two characters and return its position.

This is a 2-element implementation of indexOf(int).

Find the first one of any of the provided characters and return its position.

This is a N-element implementation of indexOf(int).

Find the index a of character, ignoring some groups.
For example:

Determine if a character is a white-space, per the Ascii standard. It only processes regular space, tab, CR and LF characters.

Determine if a character sequence is null, empty, or contains WSP chars exclusively.

Determine if a string is contained in an var-arg list of provided strings.

Validate if some starting bytes may be encoded with a particular charset.

Validate if some starting bytes may be considered as an UTF-8 printable character header.

Determine if a character is a white-space, per the Unicode standard. This method differs from isWhitespace(char) (Java language definition of a WSP).

Join a series of items. Format items using the function. For example, to display a list of long as hexadecimal separated by comma: Strings.join(", ", Arrays.asList(0x10L, 0x20L), l -> Long.toHexString(l))

Join the string representations of a sequence of objects using the provided separator. Null objects will be formatted as "null".

Join a series of non-null strings.

Join the string representations of a sequence of objects using the provided separator. Null objects will be formatted as "null".

This method is error-prone and was deprecated. Use #joinv(String, Object...) joinv instead.

Join the elements of a list using "," as a separator and surround the resulting string with square brackets. Careful, this method does not abide to the common semantic of join.

Join the string representations of a sequence of objects using the provided separator.

Join the string representations of a sequence of objects using the provided separator. Null objects will be formatted as "null".

Find the last one of two characters and return its position.

Find the last one of two characters and return its position.

This is a 2-element implementation of lastIndexOf(int).

Find the last one of any of the provided characters and return its position.

This is a N-element implementation of lastIndexOf(int).

Check whether an input string matches a provided Pattern regex pattern. This method is case-sensitive.

Check whether an input string matches a provided Pattern regex pattern. This method is case-insensitive.

Left trim on a given character.

Left trim all chars less than or equal to ' '. Note that this method differs from trim() which, for instance, does not consider CR or LF to be WSP.

Append a new-line character to the provided buffer unless the buffer is empty or the last character in the buffer is a new-line.

Replace all newline sequences by the standard \n LF charcter.

Repeat character c, iter times and build a CharSequence from it. For example pad('0', 4) will return "0000".

Parse a string as a command line. Source: ant.jar.

Same as parseUrlParameters(String, String...) with a single entry.

Extract the parameters of a URL-like encoded string. No decoding is taking place. Example:

 - s: "type=home&subtype=house&[another_key]=[another_value]"
 - entries: "type", "subtype"
 - returns: ["home", "house"]
 

Generate a 32-character long random unique identifier. The UID returned consists of the digits 0 to 9 and letters a to f (lower-case).

Retrieve the charset from start bytes. Detect UTF-8, UTF-16LE/BE and UTF-32LE-BE.

Replace the last occurrence of target in str by the replacement

Replace newline sequences. This method accepts null strings as input.

Efficiently replace all Unicode white-spaces by the provided char.

Right trim on a given character.

Right trim all chars less than or equal to ' '. Note that this method differs from trim() which, for instance, does not consider CR or LF to be WSP.

Get the string representation of the parameter object, or the empty string if the object is null.

Get the string representation of the parameter object, or the provided string if the object is null.

Get the string representation of the parameter object, or the provided non-empty string if the object is null or its string representation is the empty string.

Search for a sub-string.

Note: on JDK 11+, this implementation for regex=false, caseSensitive=false, reverseSearch=false may be slower than doing data.toLowerCase().indexOf(pattern.toLowerCase()).

Generate a repeated string of spaces.

Split a text into an array of Lines. Empty lines are returned. The final new-line character(s) are trimmed off. Works for all new lines characters (\r, \n) or sequences of characters (\r\n)

Split a text into an array of Lines. Empty lines are returned. The final new-line character(s) are trimmed off. Works for all new lines characters (\r, \n) or sequences of characters (\r\n)

Check whether an input string matches a provided pattern using a StarMatcher.

A many-element variant of String.startsWith.

Flexible version of substring(int, int). Allow Python-like negative indexes for convenience.

A safe version of String.toString.

A safe version of String.toString.

Trim (left and right) all chars less than or equal to ' '. Note that this method differs from trim() which, for instance, does not consider CR or LF to be WSP.

Trim (left and right) all chars to provided character.

Trim (left and right) all characters considered to be white-space by the Unicode standard.

Truncate a string.

Truncate a string and append an optional suffix to it if it was actually truncated.

Decode a URL-encoded string.

Urlencode a string. The resulting string will have the following characteristics:

• a-z, A-Z, 0-9 remain the same
• ., -, *, _ remain the same
• space is converted to +
• all other characters are UTF8 encoded using the "%xx" scheme