com.helger.commons.charset

Class CharsetManager

java.lang.Object

com.helger.commons.charset.CharsetManager

@Immutable
public final class CharsetManager
extends Object

Whole lotta charset management routines.

Author:

Philip Helger

Method Summary

Modifier and Type	Method and Description
static ICommonsOrderedMap<String,Charset>	getAllCharsets()
static byte[]	getAsBytes(String sText, Charset aCharset) Deprecated.
static String	getAsString(byte[] aBuffer, Charset aCharset) Deprecated.
static String	getAsString(byte[] aBuffer, int nOfs, int nLength, Charset aCharset) Deprecated.
static String	getAsStringInOtherCharset(String sText, Charset aCurrentCharset, Charset aNewCharset)
static Charset	getCharsetFromName(String sCharsetName) Resolve the charset by the specified name.
static Charset	getCharsetFromNameOrNull(String sCharsetName) Resolve the charset by the specified name.
static int	getUTF8ByteCount(char c)
static int	getUTF8ByteCount(char[] aChars) Get the number of bytes necessary to represent the passed char array as an UTF-8 string.
static int	getUTF8ByteCount(int c) Get the number of bytes necessary to represent the passed character.
static int	getUTF8ByteCount(String s) Get the number of bytes necessary to represent the passed string as an UTF-8 string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getCharsetFromName

@Nonnull
public static Charset getCharsetFromName(@Nonnull @Nonempty
                                                   String sCharsetName)

Resolve the charset by the specified name. The difference to Charset.forName(String) is, that this method has no checked exceptions but only unchecked exceptions.

Parameters:

sCharsetName - The charset to be resolved. May neither be null nor empty.

Returns:

The Charset object

Throws:

IllegalArgumentException - If the charset could not be resolved.

getCharsetFromNameOrNull

@Nullable
public static Charset getCharsetFromNameOrNull(@Nullable
                                                          String sCharsetName)

Resolve the charset by the specified name. The difference to Charset.forName(String) is, that this method throws no exceptions.

Parameters:

sCharsetName - The charset to be resolved. May be null or empty.

Returns:

The Charset object or null if no such charset was found.

getAllCharsets

@Nonnull
 @ReturnsMutableCopy
public static ICommonsOrderedMap<String,Charset> getAllCharsets()

Returns:

An immutable collection of all available charsets from the standard charset provider.

getAsBytes

@Nonnull
 @ReturnsMutableCopy
 @Deprecated
public static byte[] getAsBytes(@Nonnull
                                                                              String sText,
                                                                              @Nonnull
                                                                              Charset aCharset)

Deprecated.

getAsStringInOtherCharset

@Nullable
public static String getAsStringInOtherCharset(@Nullable
                                                          String sText,
                                                          @Nonnull
                                                          Charset aCurrentCharset,
                                                          @Nonnull
                                                          Charset aNewCharset)

getAsString

@Nonnull
 @Deprecated
public static String getAsString(@Nonnull
                                                         byte[] aBuffer,
                                                         @Nonnull
                                                         Charset aCharset)

Deprecated.

getAsString

@Nonnull
 @Deprecated
public static String getAsString(@Nonnull
                                                         byte[] aBuffer,
                                                         @Nonnegative
                                                         int nOfs,
                                                         @Nonnegative
                                                         int nLength,
                                                         @Nonnull
                                                         Charset aCharset)

Deprecated.

getUTF8ByteCount

@Nonnegative
public static int getUTF8ByteCount(@Nullable
                                                 String s)

Get the number of bytes necessary to represent the passed string as an UTF-8 string.

Parameters:

s - The string to count the length. May be null or empty.

Returns:

A non-negative value.

getUTF8ByteCount

@Nonnegative
public static int getUTF8ByteCount(@Nullable
                                                 char[] aChars)

Get the number of bytes necessary to represent the passed char array as an UTF-8 string.

Parameters:

aChars - The characters to count the length. May be null or empty.

Returns:

A non-negative value.

getUTF8ByteCount

@Nonnegative
public static int getUTF8ByteCount(char c)

getUTF8ByteCount

@Nonnegative
public static int getUTF8ByteCount(@Nonnegative
                                                 int c)

Get the number of bytes necessary to represent the passed character.

Parameters:

c - The character to be evaluated.

Returns:

A non-negative value.