20.12

java.lang.String

THE PACKAGE JAVA.LANG

If

data

 is

null

, then a

NullPointerException

 is thrown.

If

offset

 is negative, or

count

 is negative, or

offset+count

 is larger than

data.length

, then an

IndexOutOfBoundsException

 is thrown.

20.12.6

public String(byte[] ascii, int hibyte)

throws NullPointerException

This constructor initializes a newly created

String

 object so that it represents a

sequence of characters constructed from an array of 8 bit integer values. Each

character

c

 in the result string is constructed from the corresponding element

b

 of

the byte array in such a way that:

c == ((hibyte & 0xff) << 8) | (b & 0xff)

If

ascii

 is

null

, then a

NullPointerException

 is thrown.

20.12.7

public String(byte[] ascii, int hibyte,

int offset, int count)

throws NullPointerException,

IndexOutOfBoundsException

This constructor initializes a newly created

String

 object so that it represents the

sequence of characters constructed from a subarray of an array of 8 bit integer

values. The

offset

 argument is the index of the first byte of the subarray and the

count

 argument specifies the length of the subarray. Each character

c

 in the result

string is constructed from the corresponding element

b

 of the byte subarray in

such a way that:

c == ((hibyte & 0xff) << 8) | (b & 0xff)

If

ascii

 is

null

, then a

NullPointerException

 is thrown.

If

offset

 is negative, or

count

 is negative, or

offset+count

 is larger than

ascii.length

, then an

IndexOutOfBoundsException

 is thrown.

20.12.8

public String toString()

A reference to this object (which is, after all, already a

String

) is returned.

Overrides the

toString

 method of

Object

 ( 20.1.2).

534