StringUtils (SureFire API 2.19.1 API)

java.lang.Object
- org.apache.maven.surefire.util.internal.StringUtils

```
public class StringUtils
extends Object
```
Common String manipulation routines.

Originally from Turbine and the GenerationJavaCore library.

Since:

1.0

Version:

$Id: StringUtils.java 8001 2009-01-03 13:17:09Z vsiveton $

Author:

Jon S. Stevens, Daniel Rall, Greg Coladonato, Henri Yandell, Ed Korthof, Rand McNeely, Stephen Colebourne, Fredrik Westermarck, Holger Krauth, Alexander Day Chaffee, Vincent Siveton

Field Summary

Fields
Modifier and Type Field and Description

static String FORK_STREAM_CHARSET_NAME

Fields
Modifier and Type	Field and Description
`static String`	`FORK_STREAM_CHARSET_NAME`

Constructor Summary

Constructors
Constructor and Description

StringUtils()

Constructors
Constructor and Description
`StringUtils()`

Method Summary

Methods
Modifier and Type	Method and Description
`static String`	`decode(byte[] toDecode, Charset charset)`
`static byte[]`	`encode(String toEncode, Charset charset)`
`static byte[]`	`encodeStringForForkCommunication(String string)`
`static int`	`escapeBytesToPrintable(byte[] out, int outoff, byte[] input, int off, int len)` Escapes the bytes in the array `str` to contain only 'printable' bytes.
`static void`	`escapeToPrintable(StringBuilder target, CharSequence str)` Escape the specified string to a representation that only consists of nicely printable characters, without any newlines and without a comma.
`static boolean`	`isBlank(String str)` Checks if a (trimmed) String is `null` or blank.
`static boolean`	`isNotBlank(String str)` Checks if a (trimmed) String is not `null` and not blank.
`static <T> T`	`requireNonNull(T obj)`
`static <T> T`	`requireNonNull(T obj, String message)`
`static String[]`	`split(String text, String separator)`
`static ByteBuffer`	`unescapeBytes(String str, String charsetName)` Reverses the effect of `escapeBytesToPrintable(byte[], int, byte[], int, int)`.
`static void`	`unescapeString(StringBuilder target, CharSequence str)` Reverses the effect of `escapeToPrintable(StringBuilder, CharSequence)`.

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

- Field Detail
  - FORK_STREAM_CHARSET_NAME
```
public static final String FORK_STREAM_CHARSET_NAME
```
    See Also:
    Constant Field Values
- Constructor Detail
  - StringUtils
```
public StringUtils()
```
- Method Detail
  - split
```
public static String[] split(String text,
             String separator)
```
  - isBlank
```
public static boolean isBlank(String str)
```
    Checks if a (trimmed) String is null or blank.
    
    Parameters:
    str - the String to check
    
    Returns:
    true if the String is null, or length zero once trimmed
  - isNotBlank
```
public static boolean isNotBlank(String str)
```
    Checks if a (trimmed) String is not null and not blank.
    
    Parameters:
    str - the String to check
    
    Returns:
    true if the String is not null and length of trimmed str is not zero.
  - escapeToPrintable
```
public static void escapeToPrintable(StringBuilder target,
                     CharSequence str)
```
    Escape the specified string to a representation that only consists of nicely printable characters, without any newlines and without a comma.
    The reverse-method is unescapeString(StringBuilder, CharSequence).
    
    Parameters:
    target - target string buffer. The required space will be up to str.getBytes().length * 5 chars.
    str - String to escape values in, may be null.
  - unescapeString
```
public static void unescapeString(StringBuilder target,
                  CharSequence str)
```
    Reverses the effect of escapeToPrintable(StringBuilder, CharSequence).
    
    Parameters:
    target - target string buffer
    str - the String to un-escape, as created by escapeToPrintable(StringBuilder, CharSequence)
  - escapeBytesToPrintable
```
public static int escapeBytesToPrintable(byte[] out,
                         int outoff,
                         byte[] input,
                         int off,
                         int len)
```
    Escapes the bytes in the array str to contain only 'printable' bytes.
    Escaping is done by encoding the non-nicely printable bytes to '\' + upperCaseHexBytes(byte).
    A save length of out is len * 3 + outoff.
    The reverse-method is #unescapeBytes(byte[], String).
    
    Parameters:
    out - output buffer
    outoff - offset in the output buffer
    input - input buffer
    off - offset in the input buffer
    len - number of bytes to copy from the input buffer
    
    Returns:
    number of bytes written to out
  - unescapeBytes
```
public static ByteBuffer unescapeBytes(String str,
                       String charsetName)
```
    Reverses the effect of escapeBytesToPrintable(byte[], int, byte[], int, int).
    
    Parameters:
    str - the input String
    charsetName - the charset name
    
    Returns:
    the number of bytes written to out
  - decode
```
public static String decode(byte[] toDecode,
            Charset charset)
```
  - encode
```
public static byte[] encode(String toEncode,
            Charset charset)
```
  - encodeStringForForkCommunication
```
public static byte[] encodeStringForForkCommunication(String string)
```
  - requireNonNull
```
public static <T> T requireNonNull(T obj,
                   String message)
```
  - requireNonNull
```
public static <T> T requireNonNull(T obj)
```

Class StringUtils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

FORK_STREAM_CHARSET_NAME

Constructor Detail

StringUtils

Method Detail

split

isBlank

isNotBlank

escapeToPrintable

unescapeString

escapeBytesToPrintable

unescapeBytes

decode

encode

encodeStringForForkCommunication

requireNonNull

requireNonNull