|
||||||||||
| 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(java.lang.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(java.lang.String string,
java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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(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. |
private static java.lang.IllegalStateException |
newIllegalStateException(java.lang.String charsetName,
java.io.UnsupportedEncodingException e)
|
static java.lang.String |
newString(byte[] bytes,
java.lang.String charsetName)
Constructs a new String by decoding the specified array of bytes using the given charset. |
static java.lang.String |
newStringIso8859_1(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the ISO-8859-1 charset. |
static java.lang.String |
newStringUsAscii(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the US-ASCII charset. |
static java.lang.String |
newStringUtf16(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16 charset. |
static java.lang.String |
newStringUtf16Be(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16BE charset. |
static java.lang.String |
newStringUtf16Le(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16LE charset. |
static java.lang.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(java.lang.String string)
string - the String to encode
java.lang.IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUsAscii(java.lang.String string)
string - the String to encode
java.lang.IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUtf16(java.lang.String string)
string - the String to encode
java.lang.IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUtf16Be(java.lang.String string)
string - the String to encode
java.lang.IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUtf16Le(java.lang.String string)
string - the String to encode
java.lang.IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)public static byte[] getBytesUtf8(java.lang.String string)
string - the String to encode
java.lang.IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.getBytesUnchecked(String, String)
public static byte[] getBytesUnchecked(java.lang.String string,
java.lang.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 encodecharsetName - The name of a required Charset
java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen for a
required charset name.CharEncoding,
String.getBytes(String)
private static java.lang.IllegalStateException newIllegalStateException(java.lang.String charsetName,
java.io.UnsupportedEncodingException e)
public static java.lang.String newString(byte[] bytes,
java.lang.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 characterscharsetName - The name of a required Charset
String decoded from the specified array of bytes using the given charset.
java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen for a
required charset name.CharEncoding,
String.String(byte[], String)public static java.lang.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
String decoded from the specified array of bytes using the given charset.
java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static java.lang.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 given charset.
java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static java.lang.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 given charset.
java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static java.lang.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 given charset.
java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static java.lang.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 given charset.
java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the
charset is required.public static java.lang.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 given charset.
java.lang.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 | |||||||||