StringUtils (IBM COS SDK for Java 2.13.6 API)

java.lang.Object
- com.ibm.cloud.objectstorage.util.StringUtils

```
public class StringUtils
extends Object
```
Utilities for converting objects to strings.

Field Summary

Fields
Modifier and Type Field and Description

static String COMMA_SEPARATOR

static Charset UTF8

Fields
Modifier and Type	Field and Description
`static String`	`COMMA_SEPARATOR`
`static Charset`	`UTF8`

Constructor Summary

Constructors
Constructor and Description

StringUtils()

Constructors
Constructor and Description
`StringUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`appendCompactedString(StringBuilder destination, String source)` This method appends a string to a string builder and collapses contiguous white space is a single space.
`static boolean`	`beginsWithIgnoreCase(String data, String seq)` Performs a case insensitive comparison and returns true if the data begins with the given sequence.
`static int`	`compare(String str1, String str2)` Compare two strings with Locale.ENGLISH This method is preferred over String.compareTo() method.
`static Character`	`findFirstOccurrence(String s, char... charsToMatch)` Searches a string for the first occurrence of a character specified by a list of characters.
`static String`	`fromBigDecimal(BigDecimal value)`
`static String`	`fromBigInteger(BigInteger value)`
`static String`	`fromBoolean(Boolean value)`
`static String`	`fromByte(Byte b)` Returns the string representation of the specified Byte.
`static String`	`fromByteBuffer(ByteBuffer byteBuffer)` Base64 encodes the data in the specified byte buffer (from the current position to the buffer's limit) and returns it as a base64 encoded string.
`static String`	`fromDate(Date value)` Converts the specified date to an ISO 8601 timestamp string and returns it.
`static String`	`fromDate(Date date, String timestampFormat)`
`static String`	`fromDouble(Double d)` Returns the string representation of the specified double.
`static String`	`fromFloat(Float value)`
`static String`	`fromInteger(Integer value)`
`static String`	`fromLong(Long value)`
`static String`	`fromShort(Short value)`
`static String`	`fromString(String value)`
`static boolean`	`hasValue(String str)`
`static boolean`	`isNullOrEmpty(String value)`
`static String`	`join(String joiner, String... parts)` Joins the strings in parts with joiner between each string
`static String`	`lowerCase(String str)` Converts a given String to lower case with Locale.ENGLISH
`static String`	`replace(String originalString, String partToMatch, String replacement)`
`static BigDecimal`	`toBigDecimal(String s)`
`static BigInteger`	`toBigInteger(String s)`
`static Boolean`	`toBoolean(StringBuilder value)`
`static Integer`	`toInteger(StringBuilder value)`
`static String`	`toString(StringBuilder value)`
`static String`	`trim(String value)` A null-safe trim method.
`static String`	`upperCase(String str)` Converts a given String to upper case with Locale.ENGLISH

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

- Field Detail
  - COMMA_SEPARATOR
```
public static final String COMMA_SEPARATOR
```
    See Also:
    
    Constant Field Values
  - UTF8
```
public static final Charset UTF8
```
- Constructor Detail
  - StringUtils
```
public StringUtils()
```
- Method Detail
  - toInteger
```
public static Integer toInteger(StringBuilder value)
```
  - toString
```
public static String toString(StringBuilder value)
```
  - toBoolean
```
public static Boolean toBoolean(StringBuilder value)
```
  - fromInteger
```
public static String fromInteger(Integer value)
```
  - fromLong
```
public static String fromLong(Long value)
```
  - fromShort
```
public static String fromShort(Short value)
```
  - fromString
```
public static String fromString(String value)
```
  - fromBoolean
```
public static String fromBoolean(Boolean value)
```
  - fromBigInteger
```
public static String fromBigInteger(BigInteger value)
```
  - fromBigDecimal
```
public static String fromBigDecimal(BigDecimal value)
```
  - toBigInteger
```
public static BigInteger toBigInteger(String s)
```
  - toBigDecimal
```
public static BigDecimal toBigDecimal(String s)
```
  - fromFloat
```
public static String fromFloat(Float value)
```
  - fromDate
```
public static String fromDate(Date value)
```
    Converts the specified date to an ISO 8601 timestamp string and returns it.
    
    Parameters:
    
    value - The date to format as an ISO 8601 timestamp string.
    
    Returns:
    
    An ISO 8601 timestamp string created from the specified date.
  - fromDate
```
public static String fromDate(Date date,
                              String timestampFormat)
```
  - fromDouble
```
public static String fromDouble(Double d)
```
    Returns the string representation of the specified double.
    
    Parameters:
    
    d - The double to represent as a string.
    
    Returns:
    
    The string representation of the specified double.
  - fromByte
```
public static String fromByte(Byte b)
```
    Returns the string representation of the specified Byte.
    
    Parameters:
    
    b - The Byte to represent as a string.
    
    Returns:
    
    The string representation of the specified Byte.
  - fromByteBuffer
```
public static String fromByteBuffer(ByteBuffer byteBuffer)
```
    Base64 encodes the data in the specified byte buffer (from the current position to the buffer's limit) and returns it as a base64 encoded string.
    
    Parameters:
    
    byteBuffer - The data to base64 encode and return as a string; must not be null.
    
    Returns:
    
    The base64 encoded contents of the specified byte buffer.
  - replace
```
public static String replace(String originalString,
                             String partToMatch,
                             String replacement)
```
  - join
```
public static String join(String joiner,
                          String... parts)
```
    Joins the strings in parts with joiner between each string
    
    Parameters:
    
    joiner - the string to insert between the strings in parts
    
    parts - the parts to join
  - trim
```
public static String trim(String value)
```
    A null-safe trim method. If the input string is null, returns null; otherwise returns a trimmed version of the input.
  - isNullOrEmpty
```
public static boolean isNullOrEmpty(String value)
```
    Returns:
    
    true if the given value is either null or the empty string
  - hasValue
```
public static boolean hasValue(String str)
```
    Returns:
    
    true if the given value is non-null and non-empty
  - lowerCase
```
public static String lowerCase(String str)
```
    Converts a given String to lower case with Locale.ENGLISH
    
    Parameters:
    
    str - the string to be converted to lower case
    
    Returns:
    
    the lower case of string, or itself if string is null/empty
  - upperCase
```
public static String upperCase(String str)
```
    Converts a given String to upper case with Locale.ENGLISH
    
    Parameters:
    
    str - the string to be converted to upper case
    
    Returns:
    
    the upper case of string, or itself if string is null/empty
  - compare
```
public static int compare(String str1,
                          String str2)
```
    Compare two strings with Locale.ENGLISH This method is preferred over String.compareTo() method.
    
    Parameters:
    
    str1 - String 1
    
    str2 - String 2
    
    Returns:
    
    negative integer if str1 lexicographically precedes str2 positive integer if str1 lexicographically follows str2 0 if both strings are equal
    
    Throws:
    
    IllegalArgumentException - throws exception if both or either of the strings is null
  - appendCompactedString
```
public static void appendCompactedString(StringBuilder destination,
                                         String source)
```
    This method appends a string to a string builder and collapses contiguous white space is a single space. This is equivalent to: destination.append(source.replaceAll("\\s+", " ")) but does not create a Pattern object that needs to compile the match string; it also prevents us from having to make a Matcher object as well.
  - beginsWithIgnoreCase
```
public static boolean beginsWithIgnoreCase(String data,
                                           String seq)
```
    Performs a case insensitive comparison and returns true if the data begins with the given sequence.
  - findFirstOccurrence
```
public static Character findFirstOccurrence(String s,
                                            char... charsToMatch)
```
    Searches a string for the first occurrence of a character specified by a list of characters.
    
    Parameters:
    
    s - The string to search.
    
    charsToMatch - A list of characters to search the string for.
    
    Returns:
    
    The character that was first matched in the string or null if none of the characters were found.

Class StringUtils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

COMMA_SEPARATOR

UTF8

Constructor Detail

StringUtils

Method Detail

toInteger

toString

toBoolean

fromInteger

fromLong

fromShort

fromString

fromBoolean

fromBigInteger

fromBigDecimal

toBigInteger

toBigDecimal

fromFloat

fromDate

fromDate

fromDouble

fromByte

fromByteBuffer

replace

join

trim

isNullOrEmpty

hasValue

lowerCase

upperCase

compare

appendCompactedString

beginsWithIgnoreCase

findFirstOccurrence