org.beiter.michael.array

Class Converter

java.lang.Object

org.beiter.michael.array.Converter

public final class Converter
extends Object

A utility class with methods to convert arrays (e.g. from char[] to byte[]).

Method Summary

Modifier and Type	Method and Description
static byte[]	toBytes(char[] chars) Convert a char array to a byte array using the platform's default encoding as returned by Charset.defaultCharset().
static byte[]	toBytes(char[] chars, String encoding) Convert a char array to a byte array using the provided String encoding.
static char[]	toChars(byte[] bytes) Convert a byte array to a char array using the platform's default encoding as returned by Charset.defaultCharset().
static char[]	toChars(byte[] bytes, String encoding) Convert a byte array to a char array using the provided String encoding.

Methods inherited from class java.lang.Object

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

Method Detail

toBytes

public static byte[] toBytes(char[] chars)

Convert a char array to a byte array using the platform's default encoding as returned by Charset.defaultCharset().

When writing portable code, it is commonly a better practice to use toBytes(char[], String) instead of this method, and specify the encoding explicitly to avoid porting problems.

Note that this method does not change the provided source array.

Parameters:

chars - The char array to convert

Returns:

The byte[] representation of the provided char array

toBytes

public static byte[] toBytes(char[] chars,
                             String encoding)

Convert a char array to a byte array using the provided String encoding.

Note that this method does not change the provided source array.

Parameters:

chars - The char array to convert

encoding - The string encoding to use

Returns:

The byte[] representation of the provided char array

Throws:

NullPointerException - When encoding is null

IllegalArgumentException - When encoding is empty

UnsupportedCharsetException - When encoding is invalid

toChars

public static char[] toChars(byte[] bytes)

Convert a byte array to a char array using the platform's default encoding as returned by Charset.defaultCharset().

When writing portable code, it is commonly a better practice to use toBytes(char[], String) instead of this method, and specify the encoding explicitly to avoid porting problems.

Note that this method does not change the provided source array.

Parameters:

bytes - The byte array to convert

Returns:

The char[] representation of the provided byte array

toChars

public static char[] toChars(byte[] bytes,
                             String encoding)

Convert a byte array to a char array using the provided String encoding.

Note that this method does not change the provided source array.

Parameters:

bytes - The byte array to convert

encoding - The string encoding to use

Returns:

The char[] representation of the provided byte array

Throws:

NullPointerException - When encoding is null

IllegalArgumentException - When encoding is empty

UnsupportedCharsetException - When encoding is invalid