com.phloc.commons.charset

Class CharsetManager

java.lang.Object

com.phloc.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 byte[]	getAsBytes(String sText, String sCharsetName) Deprecated.
static String	getAsString(byte[] aBuffer, Charset aCharset)
static String	getAsString(byte[] aBuffer, int nOfs, int nLength, Charset aCharset)
static String	getAsString(byte[] aBuffer, int nOfs, int nLength, String sCharsetName) Deprecated.
static String	getAsString(byte[] aBuffer, String sCharsetName) Deprecated.
static String	getAsStringInOtherCharset(String sText, Charset aCurrentCharset, Charset aNewCharset)
static String	getAsStringInOtherCharset(String sText, String sCurrentCharset, String sNewCharset) Deprecated.
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
public static byte[] getAsBytes(@Nonnull
                        String sText,
                        @Nonnull
                        Charset aCharset)

getAsBytes

@Nonnull
@Deprecated
public static byte[] getAsBytes(@Nonnull
                                   String sText,
                                   @Nonnull@Nonempty
                                   String sCharsetName)

Deprecated.

getAsStringInOtherCharset

@Nullable
@Deprecated
public static String getAsStringInOtherCharset(@Nullable
                                                   String sText,
                                                   @Nonnull@Nonempty
                                                   String sCurrentCharset,
                                                   @Nonnull@Nonempty
                                                   String sNewCharset)

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@Nonempty
                                    String sCharsetName)

Deprecated.

getAsString

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

Deprecated.

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.