com.cloudhopper.commons.charset

Class GSMCharset

java.lang.Object

com.cloudhopper.commons.charset.BaseCharset

com.cloudhopper.commons.charset.GSMCharset

All Implemented Interfaces:

Charset

Direct Known Subclasses:

AirwideIA5Charset, PackedGSMCharset, TMobileNlGSMCharset, VFD2GSMCharset, VFTRGSMCharset

public class GSMCharset
extends BaseCharset

This class encodes and decodes Java Strings to and from the SMS default alphabet. It also supports the default extension table. The default alphabet and it's extension table is defined in GSM 03.38.

Author:

joelauer (twitter: @jjlauer or http://twitter.com/jjlauer)

Field Summary

Fields

Modifier and Type	Field and Description
static char[]	CHAR_TABLE
static char[]	EXT_CHAR_TABLE Extended character table.
static int	EXTENDED_ESCAPE
static int	PAGE_BREAK Page break (extended table).

Constructor Summary

Constructors

Constructor and Description
GSMCharset()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	canRepresent(CharSequence str0) Verifies that this charset can represent every character in the Java String (char sequence).
void	decode(byte[] bytes, StringBuilder buffer) Decode an SMS default alphabet-encoded octet string into a Java String.
byte[]	encode(CharSequence str0) Encode the Java string into a byte array.
int	estimateDecodeCharLength(byte[] bytes)
int	estimateEncodeByteLength(CharSequence str0)

Methods inherited from class com.cloudhopper.commons.charset.BaseCharset

decode, normalize

Methods inherited from class java.lang.Object

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

Field Detail

EXTENDED_ESCAPE

public static final int EXTENDED_ESCAPE

See Also:

Constant Field Values

PAGE_BREAK

public static final int PAGE_BREAK

Page break (extended table).

See Also:

Constant Field Values

CHAR_TABLE

public static final char[] CHAR_TABLE

EXT_CHAR_TABLE

public static final char[] EXT_CHAR_TABLE

Extended character table. Characters in this table are accessed by the 'escape' character in the base table. It is important that none of the 'inactive' characters ever be matchable with a valid base-table character as this breaks the encoding loop.

See Also:

EXTENDED_ESCAPE

Constructor Detail

GSMCharset

public GSMCharset()

Method Detail

canRepresent

public static boolean canRepresent(CharSequence str0)

Verifies that this charset can represent every character in the Java String (char sequence).

Parameters:

str0 - The String to verify

Returns:

True if the charset can represent every character in the Java String, otherwise false.

estimateEncodeByteLength

public int estimateEncodeByteLength(CharSequence str0)

encode

public byte[] encode(CharSequence str0)

Description copied from interface: Charset

Encode the Java string into a byte array.

Parameters:

str0 - The Java string to convert into a byte array

Returns:

A new byte array

estimateDecodeCharLength

public int estimateDecodeCharLength(byte[] bytes)

decode

public void decode(byte[] bytes,
          StringBuilder buffer)

Decode an SMS default alphabet-encoded octet string into a Java String.

Parameters:

bytes - The array of bytes to decode

buffer - The String buffer to append chars to