Class StringUtils
- java.lang.Object
-
- org.apache.tomcat.util.codec.binary.StringUtils
-
public class StringUtils extends Object
Converts 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 Summary
Constructors Constructor Description StringUtils()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static byte[]getBytesUtf8(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 StringnewStringUsAscii(byte[] bytes)Constructs a newStringby decoding the specified array of bytes using the US-ASCII charset.static StringnewStringUtf8(byte[] bytes)Constructs a newStringby decoding the specified array of bytes using the UTF-8 charset.
-
-
-
Method Detail
-
getBytesUtf8
public static byte[] getBytesUtf8(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 benull- Returns:
- encoded bytes, or
nullif the input string wasnull - Throws:
NullPointerException- Thrown ifStandardCharsets.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
-
newStringUsAscii
public static 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:
NullPointerException- Thrown ifStandardCharsets.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
-
newStringUtf8
public static 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:
NullPointerException- Thrown ifStandardCharsets.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
-
-