Bouncy Castle Cryptography Library 1.80 · org.bouncycastle.util.encoders.UTF8

Field Summary

Modifier and Type	Field and Description
private static final byte	C_CR1
private static final byte	C_CR2
private static final byte	C_CR3
private static final byte	C_ILL
private static final byte	C_L2A
private static final byte	C_L3A
private static final byte	C_L3B
private static final byte	C_L3C
private static final byte	C_L4A
private static final byte	C_L4B
private static final byte	C_L4C
private static final short[]	firstUnitTable
private static final byte	S_CS1
private static final byte	S_CS2
private static final byte	S_CS3
private static final byte	S_END
private static final byte	S_ERR
private static final byte	S_P3A
private static final byte	S_P3B
private static final byte	S_P4A
private static final byte	S_P4B
private static final byte[]	transitionTable

Constructor Summary

Access	Constructor and Description
public	UTF8()

Method Summary

Modifier and Type	Method and Description
private static void	fill(byte[] table, int first, int last, byte b)
public static int	Returns: The number of UTF-16 code units written to `utf16` (beginning from index 0), or else -1 if the input was either malformed or encoded any unmappable characters, or if the `utf16` is too small. transcodeToUTF16(byte[] A non-null array containing a well-formed UTF-8 encoding. utf8, char[] A non-null array, at least as long as the `utf8` array in order to ensure the output will fit. utf16) Transcode a UTF-8 encoding into a UTF-16 representation.
public static int	Returns: The number of UTF-16 code units written to `utf16` (beginning from index 0), or else -1 if the input was either malformed or encoded any unmappable characters, or if the `utf16` is too small. transcodeToUTF16(byte[] A non-null array containing a well-formed UTF-8 encoding. utf8, int start position in the array for the well-formed encoding. utf8Off, int length in bytes of the well-formed encoding. utf8Length, char[] A non-null array, at least as long as the `utf8` array in order to ensure the output will fit. utf16) Transcode a UTF-8 encoding into a UTF-16 representation.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

C_CR1	back to summary
private static final byte C_CR1

C_CR2	back to summary
private static final byte C_CR2

C_CR3	back to summary
private static final byte C_CR3

C_ILL	back to summary
private static final byte C_ILL

C_L2A	back to summary
private static final byte C_L2A

C_L3A	back to summary
private static final byte C_L3A

C_L3B	back to summary
private static final byte C_L3B

C_L3C	back to summary
private static final byte C_L3C

C_L4A	back to summary
private static final byte C_L4A

C_L4B	back to summary
private static final byte C_L4B

C_L4C	back to summary
private static final byte C_L4C

firstUnitTable	back to summary
private static final short[] firstUnitTable

S_CS1	back to summary
private static final byte S_CS1

S_CS2	back to summary
private static final byte S_CS2

S_CS3	back to summary
private static final byte S_CS3

S_END	back to summary
private static final byte S_END

S_ERR	back to summary
private static final byte S_ERR

S_P3A	back to summary
private static final byte S_P3A

S_P3B	back to summary
private static final byte S_P3B

S_P4A	back to summary
private static final byte S_P4A

S_P4B	back to summary
private static final byte S_P4B

transitionTable	back to summary
private static final byte[] transitionTable

Constructor Detail

UTF8	back to summary
public UTF8()

Method Detail

fill	back to summary
private static void fill(byte[] table, int first, int last, byte b)

transcodeToUTF16 back to summary

transcodeToUTF16	back to summary
public static int transcodeToUTF16(byte[] utf8, char[] utf16) Transcode a UTF-8 encoding into a UTF-16 representation. In the general case the output `utf16` array should be at least as long as the input `utf8` one to handle arbitrary inputs. The number of output UTF-16 code units is returned, or -1 if any errors are encountered (in which case an arbitrary amount of data may have been written into the output array). Errors that will be detected are malformed UTF-8, including incomplete, truncated or "overlong" encodings, and unmappable code points. In particular, no unmatched surrogates will be produced. An error will also result if `utf16` is found to be too small to store the complete output. Parameters utf8:byte[] A non-null array containing a well-formed UTF-8 encoding. utf16:char[] A non-null array, at least as long as the `utf8` array in order to ensure the output will fit. Returns:int The number of UTF-16 code units written to `utf16` (beginning from index 0), or else -1 if the input was either malformed or encoded any unmappable characters, or if the `utf16` is too small.

public static int transcodeToUTF16(byte[] utf8, char[] utf16)

Transcode a UTF-8 encoding into a UTF-16 representation. In the general case the output utf16 array should be at least as long as the input utf8 one to handle arbitrary inputs. The number of output UTF-16 code units is returned, or -1 if any errors are encountered (in which case an arbitrary amount of data may have been written into the output array). Errors that will be detected are malformed UTF-8, including incomplete, truncated or "overlong" encodings, and unmappable code points. In particular, no unmatched surrogates will be produced. An error will also result if utf16 is found to be too small to store the complete output.

Parameters

utf8:byte[]: A non-null array containing a well-formed UTF-8 encoding.
utf16:char[]: A non-null array, at least as long as the utf8 array in order to ensure the output will fit.

Returns:int

The number of UTF-16 code units written to utf16 (beginning from index 0), or else -1 if the input was either malformed or encoded any unmappable characters, or if the utf16 is too small.

transcodeToUTF16 back to summary

transcodeToUTF16	back to summary
public static int transcodeToUTF16(byte[] utf8, int utf8Off, int utf8Length, char[] utf16) Transcode a UTF-8 encoding into a UTF-16 representation. In the general case the output `utf16` array should be at least as long as the input length from `utf8` to handle arbitrary inputs. The number of output UTF-16 code units is returned, or -1 if any errors are encountered (in which case an arbitrary amount of data may have been written into the output array). Errors that will be detected are malformed UTF-8, including incomplete, truncated or "overlong" encodings, and unmappable code points. In particular, no unmatched surrogates will be produced. An error will also result if `utf16` is found to be too small to store the complete output. Parameters utf8:byte[] A non-null array containing a well-formed UTF-8 encoding. utf8Off:int start position in the array for the well-formed encoding. utf8Length:int length in bytes of the well-formed encoding. utf16:char[] A non-null array, at least as long as the `utf8` array in order to ensure the output will fit. Returns:int The number of UTF-16 code units written to `utf16` (beginning from index 0), or else -1 if the input was either malformed or encoded any unmappable characters, or if the `utf16` is too small.

public static int transcodeToUTF16(byte[] utf8, int utf8Off, int utf8Length, char[] utf16)

Transcode a UTF-8 encoding into a UTF-16 representation. In the general case the output utf16 array should be at least as long as the input length from utf8 to handle arbitrary inputs. The number of output UTF-16 code units is returned, or -1 if any errors are encountered (in which case an arbitrary amount of data may have been written into the output array). Errors that will be detected are malformed UTF-8, including incomplete, truncated or "overlong" encodings, and unmappable code points. In particular, no unmatched surrogates will be produced. An error will also result if utf16 is found to be too small to store the complete output.

Parameters

utf8:byte[]: A non-null array containing a well-formed UTF-8 encoding.
utf8Off:int: start position in the array for the well-formed encoding.
utf8Length:int: length in bytes of the well-formed encoding.
utf16:char[]: A non-null array, at least as long as the utf8 array in order to ensure the output will fit.

Returns:int

The number of UTF-16 code units written to utf16 (beginning from index 0), or else -1 if the input was either malformed or encoded any unmappable characters, or if the utf16 is too small.

public Class UTF8

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail