Class StringUtils
- java.lang.Object
- 
- org.apache.tomcat.util.codec.binary.StringUtils
 
- 
 public class StringUtils extends java.lang.ObjectConverts String to and from bytes using the encodings required by the Java specification. These encodings are specified in Standard charsets.This class is immutable and thread-safe. - Since:
- 1.4
- See Also:
- Standard charsets
 
- 
- 
Constructor SummaryConstructors Constructor Description StringUtils()
 - 
Method SummaryAll Methods Static Methods Concrete Methods Modifier and Type Method Description static byte[]getBytesUtf8(java.lang.String string)Encodes the given string into a sequence of bytes using the UTF-8 charset, storing the result into a new byte array.static java.lang.StringnewStringUsAscii(byte[] bytes)Constructs a newStringby decoding the specified array of bytes using the US-ASCII charset.static java.lang.StringnewStringUtf8(byte[] bytes)Constructs a newStringby decoding the specified array of bytes using the UTF-8 charset.
 
- 
- 
- 
Method Detail- 
getBytesUtf8public static byte[] getBytesUtf8(java.lang.String string) Encodes the given string into a sequence of bytes using the UTF-8 charset, storing the result into a new byte array.- Parameters:
- string- the String to encode, may be- null
- Returns:
- encoded bytes, or nullif the input string wasnull
- Throws:
- java.lang.NullPointerException- Thrown if- StandardCharsets.UTF_8is not initialized, which should never happen since it is required by the Java platform specification.
- Since:
- As of 1.7, throws NullPointerExceptioninstead of UnsupportedEncodingException
- See Also:
- Standard charsets
 
 - 
newStringUsAsciipublic static java.lang.String newStringUsAscii(byte[] bytes) Constructs a newStringby decoding the specified array of bytes using the US-ASCII charset.- Parameters:
- bytes- The bytes to be decoded into characters
- Returns:
- A new Stringdecoded from the specified array of bytes using the US-ASCII charset, ornullif the input byte array wasnull.
- Throws:
- java.lang.NullPointerException- Thrown if- StandardCharsets.US_ASCIIis not initialized, which should never happen since it is required by the Java platform specification.
- Since:
- As of 1.7, throws NullPointerExceptioninstead of UnsupportedEncodingException
 
 - 
newStringUtf8public static java.lang.String newStringUtf8(byte[] bytes) Constructs a newStringby decoding the specified array of bytes using the UTF-8 charset.- Parameters:
- bytes- The bytes to be decoded into characters
- Returns:
- A new Stringdecoded from the specified array of bytes using the UTF-8 charset, ornullif the input byte array wasnull.
- Throws:
- java.lang.NullPointerException- Thrown if- StandardCharsets.UTF_8is not initialized, which should never happen since it is required by the Java platform specification.
- Since:
- As of 1.7, throws NullPointerExceptioninstead of UnsupportedEncodingException
 
 
- 
 
-