|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.commons.codec.binary.StringUtils
public class StringUtils
Converts String to and from bytes using the encodings required by the Java specification. These encodings are specified in Standard charsets
CharEncoding,
Standard charsets| Constructor Summary | |
|---|---|
StringUtils()
|
|
| Method Summary | |
|---|---|
static byte[] |
getBytesIso8859_1(String string)
Encodes the given string into a sequence of bytes using the ISO-8859-1 charset, storing the result into a new byte array. |
static byte[] |
getBytesUnchecked(String string,
String charsetName)
Encodes the given string into a sequence of bytes using the named charset, storing the result into a new byte array. |
static byte[] |
getBytesUsAscii(String string)
Encodes the given string into a sequence of bytes using the US-ASCII charset, storing the result into a new byte array. |
static byte[] |
getBytesUtf16(String string)
Encodes the given string into a sequence of bytes using the UTF-16 charset, storing the result into a new byte array. |
static byte[] |
getBytesUtf16Be(String string)
Encodes the given string into a sequence of bytes using the UTF-16BE charset, storing the result into a new byte array. |
static byte[] |
getBytesUtf16Le(String string)
Encodes the given string into a sequence of bytes using the UTF-16LE charset, storing the result into a new byte array. |
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 String |
newString(byte[] bytes,
String charsetName)
Constructs a new String by decoding the specified array of bytes using the given charset. |
static String |
newStringIso8859_1(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the ISO-8859-1 charset. |
static String |
newStringUsAscii(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the US-ASCII charset. |
static String |
newStringUtf16(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16 charset. |
static String |
newStringUtf16Be(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16BE charset. |
static String |
newStringUtf16Le(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16LE charset. |
static String |
newStringUtf8(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-8 charset. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public StringUtils()
| Method Detail |
|---|
public static byte[] getBytesIso8859_1(String string)
string - the String to encode, may be null
null if the input string was null
IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUsAscii(String string)
string - the String to encode, may be null
null if the input string was null
IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUtf16(String string)
string - the String to encode, may be null
null if the input string was null
IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUtf16Be(String string)
string - the String to encode, may be null
null if the input string was null
IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUtf16Le(String string)
string - the String to encode, may be null
null if the input string was null
IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUtf8(String string)
string - the String to encode, may be null
null if the input string was null
IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)
public static byte[] getBytesUnchecked(String string,
String charsetName)
This method catches UnsupportedEncodingException and rethrows it as IllegalStateException, which
should never happen for a required charset name. Use this method when the encoding is required to be in the JRE.
string - the String to encode, may be nullcharsetName - The name of a required Charset
null if the input string was null
IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen for a
required charset name.CharEncoding,
String.getBytes(String)
public static String newString(byte[] bytes,
String charsetName)
String by decoding the specified array of bytes using the given charset.
This method catches UnsupportedEncodingException and re-throws it as IllegalStateException, which
should never happen for a required charset name. Use this method when the encoding is required to be in the JRE.
bytes - The bytes to be decoded into characters, may be nullcharsetName - The name of a required Charset
String decoded from the specified array of bytes using the given charset,
or null if the input byte array was null.
IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen for a
required charset name.CharEncoding,
String.String(byte[], String)public static String newStringIso8859_1(byte[] bytes)
String by decoding the specified array of bytes using the ISO-8859-1 charset.
bytes - The bytes to be decoded into characters, may be null
String decoded from the specified array of bytes using the ISO-8859-1 charset,
or null if the input byte array was null.
IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static String newStringUsAscii(byte[] bytes)
String by decoding the specified array of bytes using the US-ASCII charset.
bytes - The bytes to be decoded into characters
String decoded from the specified array of bytes using the US-ASCII charset,
or null if the input byte array was null.
IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static String newStringUtf16(byte[] bytes)
String by decoding the specified array of bytes using the UTF-16 charset.
bytes - The bytes to be decoded into characters
String decoded from the specified array of bytes using the UTF-16 charset
or null if the input byte array was null.
IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static String newStringUtf16Be(byte[] bytes)
String by decoding the specified array of bytes using the UTF-16BE charset.
bytes - The bytes to be decoded into characters
String decoded from the specified array of bytes using the UTF-16BE charset,
or null if the input byte array was null.
IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static String newStringUtf16Le(byte[] bytes)
String by decoding the specified array of bytes using the UTF-16LE charset.
bytes - The bytes to be decoded into characters
String decoded from the specified array of bytes using the UTF-16LE charset,
or null if the input byte array was null.
IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static String newStringUtf8(byte[] bytes)
String by decoding the specified array of bytes using the UTF-8 charset.
bytes - The bytes to be decoded into characters
String decoded from the specified array of bytes using the UTF-8 charset,
or null if the input byte array was null.
IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||