Strings

java.lang.Object
- org.apache.directory.api.util.Strings

```
public final class Strings
extends java.lang.Object
```
Various string manipulation methods that are more efficient then chaining string operations: all is done in the same buffer without creating a bunch of string objects.

Field Summary

Fields
Modifier and Type	Field and Description
`static byte[]`	`EMPTY_BYTES` An empty byte array
`static java.lang.String`	`EMPTY_STRING` An empty String
`private static byte[]`	`HEX_CHAR` Hex chars
`private static boolean[]`	`IS_PRINTABLE_CHAR` A table containing booleans when the corresponding char is printable
`private static org.slf4j.Logger`	`LOG` A logger for this class
`private static char[]`	`TO_LOWER_CASE`
`private static byte[]`	`TO_LOWER_CASE_BYTE`
`private static char[]`	`UPPER_CASE` upperCase = 'A' ..
`private static byte[]`	`UTF8`

Constructor Summary

Constructors
Modifier Constructor and Description

private Strings()
Private constructor

Constructors
Modifier	Constructor and Description
`private`	`Strings()` Private constructor

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static int`	`areEquals(byte[] bytes, int index, byte[] bytes2)` Check if a text is present at the current position in a buffer.
`static int`	`areEquals(byte[] bytes, int index, java.lang.String text)` Check if a text is present at the current position in a buffer.
`static int`	`areEquals(char[] chars, int index, char[] chars2)` Check if a text is present at the current position in a buffer.
`static int`	`areEquals(char[] chars, int index, char[] chars2, boolean caseSensitive)` Check if a text is present at the current position in a buffer.
`static int`	`areEquals(char[] chars, int index, java.lang.String text)` Check if a text is present at the current position in a buffer.
`static int`	`areEquals(char[] chars, int index, java.lang.String text, boolean caseSensitive)` Check if a text is present at the current position in a buffer.
`static boolean`	`areEquals(java.lang.String string, int index, java.lang.String text)` Check if a text is present at the current position in another string.
`static java.lang.String`	`asciiBytesToString(byte[] bytes)` Transform an array of ASCII bytes to a string.
`static byte`	`byteAt(byte[] bytes, int index)` Get the byte at a given position in a byte array, checking for limits
`static java.lang.String`	`centerTrunc(java.lang.String str, int head, int tail)` Truncates large Strings showing a portion of the String's head and tail with the center cut out and replaced with '...'.
`static char`	`charAt(char[] chars, int index)` Get the char at a given position in a byte array, checking for limits
`static char`	`charAt(java.lang.String string, int index)` Get the character at a given position in a string, checking for limits
`static byte[]`	`copy(byte[] value)` Copy a byte array into a new byte array
`static java.lang.String`	`deepTrim(java.lang.String string)` A deep trim of a string remove whitespace from the ends as well as excessive whitespace within the inside of the string between non-whitespace characters.
`static java.lang.String`	`deepTrim(java.lang.String str, boolean toLowerCase)` Put common code to deepTrim(String) and deepTrimToLower here.
`static java.lang.String`	`deepTrimToLower(java.lang.String string)` This does the same thing as a trim but we also lowercase the string while performing the deep trim within the same buffer.
`static java.lang.String`	`dumpByte(byte octet)` Helper function that dump a byte in hex form
`static java.lang.String`	`dumpBytes(byte[] buffer)` Helper function that dump an array of bytes in hex form
`static char`	`dumpHex(byte hex)` Helper function that returns a char from an hex
`static java.lang.String`	`dumpHexPairs(byte[] buffer)` Helper function that dump an array of bytes in hex pair form, without '0x' and space chars
`static boolean`	`equals(java.lang.String str1, java.lang.String str2)` Compares two Strings, returning `true` if they are equal.
`static java.lang.String`	`formatHtml(java.lang.String source, boolean replaceNl, boolean replaceTag, boolean replaceQuote)` This method is used to insert HTML block dynamically
`static byte[]`	`getBytesUtf8(java.lang.String string)` Return UTF-8 encoded byte[] representation of a String
`static byte[]`	`getBytesUtf8Ascii(java.lang.String string)` When the string to convert to bytes is pure ascii, this is a faster method than the getBytesUtf8.
`static java.lang.String`	`getDefaultCharsetName()` Get the default charset
`static java.lang.String`	`getString(byte[] data, int offset, int length, java.lang.String charset)` From commons-httpclients.
`static java.lang.String`	`getString(byte[] data, java.lang.String charset)` From commons-httpclients.
`static java.lang.String`	`getUUID(long value)` Create a new UUID using a long as the least significant bits
`static boolean`	`isCharASCII(byte[] byteArray, int index, char car)` Test if the current character is equal to a specific character.
`static boolean`	`isCharASCII(java.lang.String string, int index, char car)` Test if the current character is equal to a specific character.
`static boolean`	`isEmpty(byte[] bytes)` Checks if a bytes array is empty or null.
`static boolean`	`isEmpty(java.lang.String str)` Checks if a String is empty ("") or null.
`static boolean`	`isIA5String(java.lang.String str)` Check that a String is a valid IA5String.
`static boolean`	`isNotEmpty(java.lang.String str)` Checks if a String is not empty ("") and not null.
`static boolean`	`isPrintableString(java.lang.String str)` Check that a String is a valid PrintableString.
`static boolean`	`isValidUuid(java.lang.String uuid)` Checks to see if a String is a valid UUID.
`static java.lang.String`	`listToString(java.util.List<?> list)` Utility method that return a String representation of a list
`static java.lang.String`	`listToString(java.util.List<?> list, java.lang.String tabs)` Utility method that return a String representation of a list
`static java.lang.String`	`lowerCase(java.lang.String str)` Converts a String to lower case as per `String.toLowerCase()`.
`static java.lang.String`	`lowerCaseAscii(java.lang.String str)` Rewrote the toLowercase method to improve performances.
`static java.lang.String`	`mapToString(java.util.Map<?,?> map)` Utility method that return a String representation of a map.
`static java.lang.String`	`mapToString(java.util.Map<?,?> map, java.lang.String tabs)` Utility method that return a String representation of a map.
`static int`	`parseInt(java.lang.String value)` Past an ASCII String to a number
`static java.lang.String`	`setToString(java.util.Set<?> set)` Utility method that return a String representation of a set
`static byte[]`	`toByteArray(java.lang.String hexString)` Get byte array from hex string
`static java.lang.String`	`toHexString(byte[] res)` Gets a hex string from byte array.
`static java.lang.String`	`toLowerCase(byte[] value)` Rewrote the toLowercase method to improve performances.
`static java.lang.String`	`toLowerCase(java.lang.String value)` Deprecated. Use `toLowerCaseAscii(String)`
`static java.lang.String`	`toLowerCaseAscii(java.lang.String value)` Rewrote the toLowercase method to improve performances.
`static java.lang.String`	`toUpperCase(java.lang.String value)` Deprecated. Use `toUpperCaseAscii(String)`
`static java.lang.String`	`toUpperCaseAscii(java.lang.String value)` Rewrote the toLowercase method to improve performances.
`static byte[]`	`trim(byte[] bytes)` Removes spaces (char <= 32) from both start and ends of this bytes array, handling `null` by returning `null`.
`static java.lang.String`	`trim(java.lang.String str)` Removes spaces (char <= 32) from both start and ends of this String, handling `null` by returning `null`.
`static java.lang.String`	`trimConsecutiveToOne(java.lang.String str, char ch)` Trims several consecutive characters into one.
`static int`	`trimLeft(byte[] bytes, int pos)` Removes spaces (char <= 32) from start of this array, handling `null` by returning `null`.
`static void`	`trimLeft(byte[] bytes, Position pos)` Removes spaces (char <= 32) from a position in this array, handling `null` by returning `null`.
`static int`	`trimLeft(char[] chars, int pos)` Removes spaces (char <= 32) from start of this array, handling `null` by returning `null`.
`static java.lang.String`	`trimLeft(java.lang.String str)` Removes spaces (char <= 32) from start of this String, handling `null` by returning `null`.
`static void`	`trimLeft(java.lang.String string, Position pos)` Removes spaces (char <= 32) from a position in this array, handling `null` by returning `null`.
`static int`	`trimRight(byte[] bytes, int pos)` Removes spaces (char <= 32) from end of this array, handling `null` by returning `null`.
`static java.lang.String`	`trimRight(byte[] bytes, Position pos)` Removes spaces (char <= 32) from end of this string, handling `null` by returning `null`.
`static int`	`trimRight(char[] chars, int pos)` Removes spaces (char <= 32) from end of this array, handling `null` by returning `null`.
`static java.lang.String`	`trimRight(java.lang.String str)` Removes spaces (char <= 32) from end of this String, handling `null` by returning `null`.
`static java.lang.String`	`trimRight(java.lang.String str, int escapedSpace)` Removes spaces (char <= 32) from end of this String, handling `null` by returning `null`.
`static java.lang.String`	`trimRight(java.lang.String string, Position pos)` Removes spaces (char <= 32) from end of this string, handling `null` by returning `null`.
`static java.lang.String`	`upperCase(java.lang.String str)` Converts a String to upper case as per `String#toUpperCase( Locale.ROOT )`.
`static java.lang.String`	`utf8ToString(byte[] bytes)` Return an UTF-8 encoded String
`static java.lang.String`	`utf8ToString(byte[] bytes, int length)` Return an UTF-8 encoded String
`static java.lang.String`	`utf8ToString(byte[] bytes, int start, int length)` Return an UTF-8 encoded String
`static byte[]`	`uuidToBytes(java.lang.String string)` converts the string representation of an UUID to bytes
`static java.lang.String`	`uuidToString(byte[] bytes)` converts the bytes of a UUID to string

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

- Field Detail
  - LOG
```
private static final org.slf4j.Logger LOG
```
    A logger for this class
  - HEX_CHAR
```
private static final byte[] HEX_CHAR
```
    Hex chars
  - IS_PRINTABLE_CHAR
```
private static final boolean[] IS_PRINTABLE_CHAR
```
    A table containing booleans when the corresponding char is printable
  - TO_LOWER_CASE
```
private static final char[] TO_LOWER_CASE
```
  - TO_LOWER_CASE_BYTE
```
private static final byte[] TO_LOWER_CASE_BYTE
```
  - UPPER_CASE
```
private static final char[] UPPER_CASE
```
    upperCase = 'A' .. 'Z', '0'..'9', '-'
  - EMPTY_BYTES
```
public static final byte[] EMPTY_BYTES
```
    An empty byte array
  - EMPTY_STRING
```
public static final java.lang.String EMPTY_STRING
```
    An empty String
    
    See Also:
    
    Constant Field Values
  - UTF8
```
private static final byte[] UTF8
```
- Constructor Detail
  - Strings
```
private Strings()
```
    Private constructor
- Method Detail
  - dumpBytes
```
public static java.lang.String dumpBytes(byte[] buffer)
```
    Helper function that dump an array of bytes in hex form
    
    Parameters:
    
    buffer - The bytes array to dump
    
    Returns:
    
    A string representation of the array of bytes
  - dumpByte
```
public static java.lang.String dumpByte(byte octet)
```
    Helper function that dump a byte in hex form
    
    Parameters:
    
    octet - The byte to dump
    
    Returns:
    
    A string representation of the byte
  - dumpHex
```
public static char dumpHex(byte hex)
```
    Helper function that returns a char from an hex
    
    Parameters:
    
    hex - The hex to dump
    
    Returns:
    
    A char representation of the hex
  - dumpHexPairs
```
public static java.lang.String dumpHexPairs(byte[] buffer)
```
    Helper function that dump an array of bytes in hex pair form, without '0x' and space chars
    
    Parameters:
    
    buffer - The bytes array to dump
    
    Returns:
    
    A string representation of the array of bytes
  - deepTrim
```
public static java.lang.String deepTrim(java.lang.String str,
                                        boolean toLowerCase)
```
    Put common code to deepTrim(String) and deepTrimToLower here.
    
    Parameters:
    
    str - the string to deep trim
    
    toLowerCase - how to normalize for case: upper or lower
    
    Returns:
    
    the deep trimmed string
    
    See Also:
    
    TODO Replace the toCharArray() by substring manipulations
  - deepTrimToLower
```
public static java.lang.String deepTrimToLower(java.lang.String string)
```
    This does the same thing as a trim but we also lowercase the string while performing the deep trim within the same buffer. This saves us from having to create multiple String and StringBuffer objects and is much more efficient.
    
    See Also:
    
    deepTrim( String )
  - deepTrim
```
public static java.lang.String deepTrim(java.lang.String string)
```
    A deep trim of a string remove whitespace from the ends as well as excessive whitespace within the inside of the string between non-whitespace characters. A deep trim reduces internal whitespace down to a single space to preserve the whitespace separated tokenization order of the String.
    
    Parameters:
    
    string - the string to deep trim.
    
    Returns:
    
    the trimmed string.
  - trimConsecutiveToOne
```
public static java.lang.String trimConsecutiveToOne(java.lang.String str,
                                                    char ch)
```
    Trims several consecutive characters into one.
    
    Parameters:
    
    str - the string to trim consecutive characters of
    
    ch - the character to trim down
    
    Returns:
    
    the newly trimmed down string
  - centerTrunc
```
public static java.lang.String centerTrunc(java.lang.String str,
                                           int head,
                                           int tail)
```
    Truncates large Strings showing a portion of the String's head and tail with the center cut out and replaced with '...'. Also displays the total length of the truncated string so size of '...' can be interpreted. Useful for large strings in UIs or hex dumps to log files.
    
    Parameters:
    
    str - the string to truncate
    
    head - the amount of the head to display
    
    tail - the amount of the tail to display
    
    Returns:
    
    the center truncated string
  - toHexString
```
public static java.lang.String toHexString(byte[] res)
```
    Gets a hex string from byte array.
    
    Parameters:
    
    res - the byte array
    
    Returns:
    
    the hex string representing the binary values in the array
  - toByteArray
```
public static byte[] toByteArray(java.lang.String hexString)
```
    Get byte array from hex string
    
    Parameters:
    
    hexString - the hex string to convert to a byte array
    
    Returns:
    
    the byte form of the hex string.
  - formatHtml
```
public static java.lang.String formatHtml(java.lang.String source,
                                          boolean replaceNl,
                                          boolean replaceTag,
                                          boolean replaceQuote)
```
    This method is used to insert HTML block dynamically
    
    Parameters:
    
    source - the HTML code to be processes
    
    replaceNl - if true '\n' will be replaced by <br>
    
    replaceTag - if true '<' will be replaced by < and '>' will be replaced by >
    
    replaceQuote - if true '\"' will be replaced by "
    
    Returns:
    
    the formated html block
  - areEquals
```
public static boolean areEquals(java.lang.String string,
                                int index,
                                java.lang.String text)
```
    Check if a text is present at the current position in another string.
    
    Parameters:
    
    string - The string which contains the data
    
    index - Current position in the string
    
    text - The text we want to check
    
    Returns:
    
    true if the string contains the text.
  - isCharASCII
```
public static boolean isCharASCII(byte[] byteArray,
                                  int index,
                                  char car)
```
    Test if the current character is equal to a specific character. This function works only for character between 0 and 127, as it does compare a byte and a char (which is 16 bits wide)
    
    Parameters:
    
    byteArray - The buffer which contains the data
    
    index - Current position in the buffer
    
    car - The character we want to compare with the current buffer position
    
    Returns:
    
    true if the current character equals the given character.
  - isCharASCII
```
public static boolean isCharASCII(java.lang.String string,
                                  int index,
                                  char car)
```
    Test if the current character is equal to a specific character.
    
    Parameters:
    
    string - The String which contains the data
    
    index - Current position in the string
    
    car - The character we want to compare with the current string position
    
    Returns:
    
    true if the current character equals the given character.
  - utf8ToString
```
public static java.lang.String utf8ToString(byte[] bytes)
```
    Return an UTF-8 encoded String
    
    Parameters:
    
    bytes - The byte array to be transformed to a String
    
    Returns:
    
    A String.
  - utf8ToString
```
public static java.lang.String utf8ToString(byte[] bytes,
                                            int length)
```
    Return an UTF-8 encoded String
    
    Parameters:
    
    bytes - The byte array to be transformed to a String
    
    length - The length of the byte array to be converted
    
    Returns:
    
    A String.
  - utf8ToString
```
public static java.lang.String utf8ToString(byte[] bytes,
                                            int start,
                                            int length)
```
    Return an UTF-8 encoded String
    
    Parameters:
    
    bytes - The byte array to be transformed to a String
    
    start - the starting position in the byte array
    
    length - The length of the byte array to be converted
    
    Returns:
    
    A String.
  - areEquals
```
public static int areEquals(byte[] bytes,
                            int index,
                            java.lang.String text)
```
    Check if a text is present at the current position in a buffer.
    
    Parameters:
    
    bytes - The buffer which contains the data
    
    index - Current position in the buffer
    
    text - The text we want to check
    
    Returns:
    
    true if the buffer contains the text.
  - areEquals
```
public static int areEquals(char[] chars,
                            int index,
                            java.lang.String text)
```
    Check if a text is present at the current position in a buffer.
    
    Parameters:
    
    chars - The buffer which contains the data
    
    index - Current position in the buffer
    
    text - The text we want to check
    
    Returns:
    
    true if the buffer contains the text.
  - areEquals
```
public static int areEquals(char[] chars,
                            int index,
                            java.lang.String text,
                            boolean caseSensitive)
```
    Check if a text is present at the current position in a buffer.
    
    Parameters:
    
    chars - The buffer which contains the data
    
    index - Current position in the buffer
    
    text - The text we want to check
    
    caseSensitive - If the comparison is case-sensitive
    
    Returns:
    
    true if the buffer contains the text.
  - areEquals
```
public static int areEquals(char[] chars,
                            int index,
                            char[] chars2)
```
    Check if a text is present at the current position in a buffer.
    
    Parameters:
    
    chars - The buffer which contains the data
    
    index - Current position in the buffer
    
    chars2 - The text we want to check
    
    Returns:
    
    true if the buffer contains the text.
  - areEquals
```
public static int areEquals(char[] chars,
                            int index,
                            char[] chars2,
                            boolean caseSensitive)
```
    Check if a text is present at the current position in a buffer.
    
    Parameters:
    
    chars - The buffer which contains the data
    
    index - Current position in the buffer
    
    chars2 - The text we want to check
    
    caseSensitive - If the comparison is case-sensitive
    
    Returns:
    
    true if the buffer contains the text.
  - areEquals
```
public static int areEquals(byte[] bytes,
                            int index,
                            byte[] bytes2)
```
    Check if a text is present at the current position in a buffer.
    
    Parameters:
    
    bytes - The buffer which contains the data
    
    index - Current position in the buffer
    
    bytes2 - The text we want to check
    
    Returns:
    
    true if the buffer contains the text.
  - isEmpty
```
public static boolean isEmpty(java.lang.String str)
```
    Checks if a String is empty ("") or null.
```
  StringUtils.isEmpty(null)      = true
  StringUtils.isEmpty("")        = true
  StringUtils.isEmpty(" ")       = false
  StringUtils.isEmpty("bob")     = false
  StringUtils.isEmpty("  bob  ") = false
 
```
    NOTE: This method changed in Lang version 2.0. It no longer trims the String. That functionality is available in isBlank().
    Parameters:
    
    str - the String to check, may be null
    
    Returns:
    
    true if the String is empty or null
  - isEmpty
```
public static boolean isEmpty(byte[] bytes)
```
    Checks if a bytes array is empty or null.
    
    Parameters:
    
    bytes - The bytes array to check, may be null
    
    Returns:
    
    true if the bytes array is empty or null
  - trim
```
public static java.lang.String trim(java.lang.String str)
```
    Removes spaces (char <= 32) from both start and ends of this String, handling null by returning null.
    Trim removes start and end characters <= 32.
```
  StringUtils.trim(null)          = null
  StringUtils.trim("")            = ""
  StringUtils.trim("     ")       = ""
  StringUtils.trim("abc")         = "abc"
  StringUtils.trim("    abc    ") = "abc"
 
```
    Parameters:
    
    str - the String to be trimmed, may be null
    
    Returns:
    
    the trimmed string, null if null String input
  - trim
```
public static byte[] trim(byte[] bytes)
```
    Removes spaces (char <= 32) from both start and ends of this bytes array, handling null by returning null.
    Trim removes start and end characters <= 32.
```
  StringUtils.trim(null)          = null
  StringUtils.trim("")            = ""
  StringUtils.trim("     ")       = ""
  StringUtils.trim("abc")         = "abc"
  StringUtils.trim("    abc    ") = "abc"
 
```
    Parameters:
    
    bytes - the byte array to be trimmed, may be null
    
    Returns:
    
    the trimmed byte array
  - trimLeft
```
public static java.lang.String trimLeft(java.lang.String str)
```
    Removes spaces (char <= 32) from start of this String, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimLeft(null)          = null
  StringUtils.trimLeft("")            = ""
  StringUtils.trimLeft("     ")       = ""
  StringUtils.trimLeft("abc")         = "abc"
  StringUtils.trimLeft("    abc    ") = "abc    "
 
```
    Parameters:
    
    str - the String to be trimmed, may be null
    
    Returns:
    
    the trimmed string, null if null String input
  - trimLeft
```
public static int trimLeft(char[] chars,
                           int pos)
```
    Removes spaces (char <= 32) from start of this array, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimLeft(null)          = null
  StringUtils.trimLeft("")            = ""
  StringUtils.trimLeft("     ")       = ""
  StringUtils.trimLeft("abc")         = "abc"
  StringUtils.trimLeft("    abc    ") = "abc    "
 
```
    Parameters:
    
    chars - the chars array to be trimmed, may be null
    
    Returns:
    
    the position of the first char which is not a space, or the last position of the array.
  - trimLeft
```
public static void trimLeft(java.lang.String string,
                            Position pos)
```
    Removes spaces (char <= 32) from a position in this array, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimLeft(null)          = null
  StringUtils.trimLeft("",...)            = ""
  StringUtils.trimLeft("     ",...)       = ""
  StringUtils.trimLeft("abc",...)         = "abc"
  StringUtils.trimLeft("    abc    ",...) = "abc    "
 
```
    Parameters:
    
    string - the string to be trimmed, may be null
    
    pos - The starting position
  - trimLeft
```
public static void trimLeft(byte[] bytes,
                            Position pos)
```
    Removes spaces (char <= 32) from a position in this array, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimLeft(null)          = null
  StringUtils.trimLeft("",...)            = ""
  StringUtils.trimLeft("     ",...)       = ""
  StringUtils.trimLeft("abc",...)         = "abc"
  StringUtils.trimLeft("    abc    ",...) = "abc    "
 
```
    Parameters:
    
    bytes - the byte array to be trimmed, may be null
    
    pos - The starting position
  - trimLeft
```
public static int trimLeft(byte[] bytes,
                           int pos)
```
    Removes spaces (char <= 32) from start of this array, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimLeft(null)          = null
  StringUtils.trimLeft("")            = ""
  StringUtils.trimLeft("     ")       = ""
  StringUtils.trimLeft("abc")         = "abc"
  StringUtils.trimLeft("    abc    ") = "abc    "
 
```
    Parameters:
    
    bytes - the byte array to be trimmed, may be null
    
    Returns:
    
    the position of the first byte which is not a space, or the last position of the array.
  - trimRight
```
public static java.lang.String trimRight(java.lang.String str)
```
    Removes spaces (char <= 32) from end of this String, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimRight(null)          = null
  StringUtils.trimRight("")            = ""
  StringUtils.trimRight("     ")       = ""
  StringUtils.trimRight("abc")         = "abc"
  StringUtils.trimRight("    abc    ") = "    abc"
 
```
    Parameters:
    
    str - the String to be trimmed, may be null
    
    Returns:
    
    the trimmed string, null if null String input
  - trimRight
```
public static java.lang.String trimRight(java.lang.String str,
                                         int escapedSpace)
```
    Removes spaces (char <= 32) from end of this String, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimRight(null)          = null
  StringUtils.trimRight("")            = ""
  StringUtils.trimRight("     ")       = ""
  StringUtils.trimRight("abc")         = "abc"
  StringUtils.trimRight("    abc    ") = "    abc"
 
```
    Parameters:
    
    str - the String to be trimmed, may be null
    
    escapedSpace - The last escaped space, if any
    
    Returns:
    
    the trimmed string, null if null String input
  - trimRight
```
public static int trimRight(char[] chars,
                            int pos)
```
    Removes spaces (char <= 32) from end of this array, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimRight(null)          = null
  StringUtils.trimRight("")            = ""
  StringUtils.trimRight("     ")       = ""
  StringUtils.trimRight("abc")         = "abc"
  StringUtils.trimRight("    abc    ") = "    abc"
 
```
    Parameters:
    
    chars - the chars array to be trimmed, may be null
    
    Returns:
    
    the position of the first char which is not a space, or the last position of the array.
  - trimRight
```
public static java.lang.String trimRight(java.lang.String string,
                                         Position pos)
```
    Removes spaces (char <= 32) from end of this string, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimRight(null)          = null
  StringUtils.trimRight("")            = ""
  StringUtils.trimRight("     ")       = ""
  StringUtils.trimRight("abc")         = "abc"
  StringUtils.trimRight("    abc    ") = "    abc"
 
```
    Parameters:
    
    string - the string to be trimmed, may be null
    
    Returns:
    
    the position of the first char which is not a space, or the last position of the string.
  - trimRight
```
public static java.lang.String trimRight(byte[] bytes,
                                         Position pos)
```
    Removes spaces (char <= 32) from end of this string, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimRight(null)          = null
  StringUtils.trimRight("")            = ""
  StringUtils.trimRight("     ")       = ""
  StringUtils.trimRight("abc")         = "abc"
  StringUtils.trimRight("    abc    ") = "    abc"
 
```
    Parameters:
    
    bytes - the byte array to be trimmed, may be null
    
    Returns:
    
    the position of the first char which is not a space, or the last position of the byte array.
  - trimRight
```
public static int trimRight(byte[] bytes,
                            int pos)
```
    Removes spaces (char <= 32) from end of this array, handling null by returning null.
    Trim removes start characters <= 32.
```
  StringUtils.trimRight(null)          = null
  StringUtils.trimRight("")            = ""
  StringUtils.trimRight("     ")       = ""
  StringUtils.trimRight("abc")         = "abc"
  StringUtils.trimRight("    abc    ") = "    abc"
 
```
    Parameters:
    
    bytes - the byte array to be trimmed, may be null
    
    Returns:
    
    the position of the first char which is not a space, or the last position of the array.
  - charAt
```
public static char charAt(java.lang.String string,
                          int index)
```
    Get the character at a given position in a string, checking for limits
    
    Parameters:
    
    string - The string which contains the data
    
    index - Current position in the string
    
    Returns:
    
    The character at the given position, or '\0' if something went wrong
  - byteAt
```
public static byte byteAt(byte[] bytes,
                          int index)
```
    Get the byte at a given position in a byte array, checking for limits
    
    Parameters:
    
    bytes - The byte[] which contains the data
    
    index - Current position in the byte[]
    
    Returns:
    
    The byte at the given position, or '\0' if something went wrong
  - charAt
```
public static char charAt(char[] chars,
                          int index)
```
    Get the char at a given position in a byte array, checking for limits
    
    Parameters:
    
    chars - The char[] which contains the data
    
    index - Current position in the char[]
    
    Returns:
    
    The byte at the given position, or '\0' if something went wrong
  - asciiBytesToString
```
public static java.lang.String asciiBytesToString(byte[] bytes)
```
    Transform an array of ASCII bytes to a string. the byte array should contains only values in [0, 127].
    
    Parameters:
    
    bytes - The byte array to transform
    
    Returns:
    
    The resulting string
  - getBytesUtf8
```
public static byte[] getBytesUtf8(java.lang.String string)
```
    Return UTF-8 encoded byte[] representation of a String
    
    Parameters:
    
    string - The string to be transformed to a byte array
    
    Returns:
    
    The transformed byte array
  - getBytesUtf8Ascii
```
public static byte[] getBytesUtf8Ascii(java.lang.String string)
```
    When the string to convert to bytes is pure ascii, this is a faster method than the getBytesUtf8. Otherwise, it's slower.
    
    Parameters:
    
    string - The string to convert to byte[]
    
    Returns:
    
    The bytes
  - getDefaultCharsetName
```
public static java.lang.String getDefaultCharsetName()
```
    Get the default charset
    
    Returns:
    
    The default charset
  - equals
```
public static boolean equals(java.lang.String str1,
                             java.lang.String str2)
```
    Compares two Strings, returning true if they are equal.
    
    nulls are handled without exceptions. Two null references are considered to be equal. The comparison is case sensitive.
```
  StringUtils.equals(null, null)   = true
  StringUtils.equals(null, "abc")  = false
  StringUtils.equals("abc", null)  = false
  StringUtils.equals("abc", "abc") = true
  StringUtils.equals("abc", "ABC") = false
 
```
    Parameters:
    
    str1 - the first String, may be null
    
    str2 - the second String, may be null
    
    Returns:
    
    true if the Strings are equal, case sensitive, or both null
    
    See Also:
    
    String.equals(Object)
  - listToString
```
public static java.lang.String listToString(java.util.List<?> list)
```
    Utility method that return a String representation of a list
    
    Parameters:
    
    list - The list to transform to a string
    
    Returns:
    
    A csv string
  - setToString
```
public static java.lang.String setToString(java.util.Set<?> set)
```
    Utility method that return a String representation of a set
    
    Parameters:
    
    set - The set to transform to a string
    
    Returns:
    
    A csv string
  - listToString
```
public static java.lang.String listToString(java.util.List<?> list,
                                            java.lang.String tabs)
```
    Utility method that return a String representation of a list
    
    Parameters:
    
    list - The list to transform to a string
    
    tabs - The tabs to add in front of the elements
    
    Returns:
    
    A csv string
  - mapToString
```
public static java.lang.String mapToString(java.util.Map<?,?> map)
```
    Utility method that return a String representation of a map. The elements will be represented as "key = value"
    
    Parameters:
    
    map - The map to transform to a string
    
    Returns:
    
    A csv string
  - mapToString
```
public static java.lang.String mapToString(java.util.Map<?,?> map,
                                           java.lang.String tabs)
```
    Utility method that return a String representation of a map. The elements will be represented as "key = value"
    
    Parameters:
    
    map - The map to transform to a string
    
    tabs - The tabs to add in ffront of the elements
    
    Returns:
    
    A csv string
  - toLowerCase
```
public static java.lang.String toLowerCase(java.lang.String value)
```
    Deprecated. Use toLowerCaseAscii(String)
    
    Rewrote the toLowercase method to improve performances. In Ldap, attributesType are supposed to use ASCII chars : 'a'-'z', 'A'-'Z', '0'-'9', '.' and '-' only.
    
    Parameters:
    
    value - The String to lowercase
    
    Returns:
    
    The lowercase string
  - toLowerCaseAscii
```
public static java.lang.String toLowerCaseAscii(java.lang.String value)
```
    Rewrote the toLowercase method to improve performances. In Ldap, attributesType are supposed to use ASCII chars : 'a'-'z', 'A'-'Z', '0'-'9', '.' and '-' only.
    
    Parameters:
    
    value - The String to lowercase
    
    Returns:
    
    The lowercase string
  - toLowerCase
```
public static java.lang.String toLowerCase(byte[] value)
```
    Rewrote the toLowercase method to improve performances. In Ldap, attributesType are supposed to use ASCII chars : 'a'-'z', 'A'-'Z', '0'-'9', '.' and '-' only.
    
    Parameters:
    
    value - The byte[] to lowercase
    
    Returns:
    
    The lowercase string
  - toUpperCase
```
public static java.lang.String toUpperCase(java.lang.String value)
```
    Deprecated. Use toUpperCaseAscii(String)
    
    Rewrote the toLowercase method to improve performances. In Ldap, attributesType are supposed to use ASCII chars : 'a'-'z', 'A'-'Z', '0'-'9', '.' and '-' only.
    
    Parameters:
    
    value - The String to uppercase
    
    Returns:
    
    The uppercase string
  - toUpperCaseAscii
```
public static java.lang.String toUpperCaseAscii(java.lang.String value)
```
    Rewrote the toLowercase method to improve performances. In Ldap, attributesType are supposed to use ASCII chars : 'a'-'z', 'A'-'Z', '0'-'9', '.' and '-' only.
    
    Parameters:
    
    value - The String to uppercase
    
    Returns:
    
    The uppercase string
  - upperCase
```
public static java.lang.String upperCase(java.lang.String str)
```
    Converts a String to upper case as per String#toUpperCase( Locale.ROOT ).
    
    A null input String returns null.
```
  StringUtils.upperCase(null)  = null
  StringUtils.upperCase("")    = ""
  StringUtils.upperCase("aBc") = "ABC"
 
```
    Parameters:
    
    str - the String to upper case, may be null
    
    Returns:
    
    the upper cased String, null if null String input
  - lowerCase
```
public static java.lang.String lowerCase(java.lang.String str)
```
    Converts a String to lower case as per String.toLowerCase().
    
    A null input String returns null.
```
  StringUtils.lowerCase(null)  = null
  StringUtils.lowerCase("")    = ""
  StringUtils.lowerCase("aBc") = "abc"
 
```
    Parameters:
    
    str - the String to lower case, may be null
    
    Returns:
    
    the lower cased String, null if null String input
  - lowerCaseAscii
```
public static java.lang.String lowerCaseAscii(java.lang.String str)
```
    Rewrote the toLowercase method to improve performances. In Ldap, attributesType are supposed to use ASCII chars : 'a'-'z', 'A'-'Z', '0'-'9', '.' and '-' only. We will take care of any other chars either.
    
    Parameters:
    
    str - The String to lowercase
    
    Returns:
    
    The lowercase string
  - isPrintableString
```
public static boolean isPrintableString(java.lang.String str)
```
    Check that a String is a valid PrintableString. A PrintableString contains only the following set of chars : { ' ', ''', '(', ')', '+', '-', '.', '/', [0-9], ':', '=', '?', [A-Z], [a-z]}
    
    Parameters:
    
    str - The String to check
    
    Returns:
    
    true if the string is a PrintableString or is empty, false otherwise
  - isNotEmpty
```
public static boolean isNotEmpty(java.lang.String str)
```
    Checks if a String is not empty ("") and not null.
```
  StringUtils.isNotEmpty(null)      = false
  StringUtils.isNotEmpty("")        = false
  StringUtils.isNotEmpty(" ")       = true
  StringUtils.isNotEmpty("bob")     = true
  StringUtils.isNotEmpty("  bob  ") = true
 
```
    Parameters:
    
    str - the String to check, may be null
    
    Returns:
    
    true if the String is not empty and not null
  - isIA5String
```
public static boolean isIA5String(java.lang.String str)
```
    Check that a String is a valid IA5String. An IA5String contains only char which values is between [0, 7F]
    
    Parameters:
    
    str - The String to check
    
    Returns:
    
    true if the string is an IA5String or is empty, false otherwise
  - isValidUuid
```
public static boolean isValidUuid(java.lang.String uuid)
```
    Checks to see if a String is a valid UUID.
    
    Parameters:
    
    uuid - the UUID to check for validity
    
    Returns:
    
    true if the UUID is valid, false otherwise
  - uuidToString
```
public static java.lang.String uuidToString(byte[] bytes)
```
    converts the bytes of a UUID to string
    
    Parameters:
    
    bytes - bytes of a UUID
    
    Returns:
    
    UUID in string format
  - uuidToBytes
```
public static byte[] uuidToBytes(java.lang.String string)
```
    converts the string representation of an UUID to bytes
    
    Parameters:
    
    string - the string representation of an UUID
    
    Returns:
    
    the bytes, null if the the syntax is not valid
  - copy
```
public static byte[] copy(byte[] value)
```
    Copy a byte array into a new byte array
    
    Parameters:
    
    value - the byte array to copy
    
    Returns:
    
    The copied byte array
  - getString
```
public static java.lang.String getString(byte[] data,
                                         int offset,
                                         int length,
                                         java.lang.String charset)
```
    From commons-httpclients. Converts the byte array of HTTP content characters to a string. If the specified charset is not supported, default system encoding is used.
    
    Parameters:
    
    data - the byte array to be encoded
    
    offset - the index of the first byte to encode
    
    length - the number of bytes to encode
    
    charset - the desired character encoding
    
    Returns:
    
    The result of the conversion.
    
    Since:
    
    3.0
  - getString
```
public static java.lang.String getString(byte[] data,
                                         java.lang.String charset)
```
    From commons-httpclients. Converts the byte array of HTTP content characters to a string. If the specified charset is not supported, default system encoding is used.
    
    Parameters:
    
    data - the byte array to be encoded
    
    charset - the desired character encoding
    
    Returns:
    
    The result of the conversion.
    
    Since:
    
    3.0
  - getUUID
```
public static java.lang.String getUUID(long value)
```
    Create a new UUID using a long as the least significant bits
    
    Parameters:
    
    value - The least significant bits.
    
    Returns:
  - parseInt
```
public static int parseInt(java.lang.String value)
                    throws java.lang.NumberFormatException
```
    Past an ASCII String to a number
    
    Parameters:
    
    value - The string to parse
    
    Returns:
    
    the parsed value.
    
    Throws:
    
    java.lang.NumberFormatException - If we don't have a number

Class Strings

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LOG

HEX_CHAR

IS_PRINTABLE_CHAR

TO_LOWER_CASE

TO_LOWER_CASE_BYTE

UPPER_CASE

EMPTY_BYTES

EMPTY_STRING

UTF8

Constructor Detail

Strings

Method Detail

dumpBytes

dumpByte

dumpHex

dumpHexPairs

deepTrim

deepTrimToLower

deepTrim

trimConsecutiveToOne

centerTrunc

toHexString

toByteArray

formatHtml

areEquals

isCharASCII

isCharASCII

utf8ToString

utf8ToString

utf8ToString

areEquals

areEquals

areEquals

areEquals

areEquals

areEquals

isEmpty

isEmpty

trim

trim

trimLeft

trimLeft

trimLeft

trimLeft

trimLeft

trimRight

trimRight

trimRight

trimRight

trimRight

trimRight

charAt

byteAt

charAt

asciiBytesToString

getBytesUtf8

getBytesUtf8Ascii

getDefaultCharsetName

equals

listToString

setToString

listToString

mapToString

mapToString

toLowerCase

toLowerCaseAscii

toLowerCase

toUpperCase

toUpperCaseAscii

upperCase

lowerCase

lowerCaseAscii

isPrintableString

isNotEmpty