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

Methods

Modifier and Type	Method and Description
static SortedMap<String,Charset>	getAllCharsets()
static byte[]	getAsBytes(String sText, Charset aCharset)
static String	getAsString(byte[] aBuffer, Charset aCharset)
static String	getAsString(byte[] aBuffer, int nOfs, int nLength, Charset aCharset)
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
@ReturnsImmutableObject
public static SortedMap<String,Charset> getAllCharsets()

Returns:

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

getAsBytes

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

getAsStringInOtherCharset

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

getAsString

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

getAsString

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

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.