java.nio
クラス CharBuffer

java.lang.Object
  |
  +--java.nio.Buffer
        |
        +--java.nio.CharBuffer

すべての実装インタフェース:

CharSequence, Comparable

public abstract class CharBuffer

extends Buffer

implements Comparable, CharSequence

char バッファです。

このクラスは、char バッファに対する操作を 4 つのカテゴリに分類します。

• 単一の文字の読み込みと書き込みを行う絶対および相対「get」/「put」メソッド

• 連続した文字シーケンスを現在のバッファから配列へと転送する相対「一括 get」メソッド

• 連続した文字シーケンスを char 配列、文字列、またはその他の char バッファから現在のバッファへと転送する相対「一括 put」メソッド

• char バッファの圧縮、複製、スライス用メソッド

char バッファは、バッファのコンテンツに容量を割り当てる方法 (容量の割り当て)、既存の char 配列や文字列をバッファにラップする方法 (ラップ)、既存の byte バッファの「ビュー」を作成する方法で作成できます。

byte バッファと同様に、char バッファにも「ダイレクト」バッファと「非ダイレクト」バッファがあります。このクラスの wrap メソッドで作成された char バッファは非ダイレクトバッファになります。byte バッファのビューとして作成された char バッファは、byte バッファがダイレクトバッファである場合にかぎりダイレクトバッファになります。char バッファがダイレクトバッファであるかどうかは、isDirect メソッドを呼び出すことで判断できます。

このクラスは CharSequence インタフェースを実装します。このため、文字シーケンスが受け付けられる場所であればどこでも、char バッファを使用できます。たとえば、正規表現のパッケージ java.util.regex での使用が可能です。

このクラスのメソッドのうち戻り値を返さないものは、自身を呼び出したバッファの情報を返します。これを応用して、メソッド呼び出しを連鎖させることができます。 たとえば、次のような連続した文があるとしましょう。

 cb.put("text/");
 cb.put(subtype);
 cb.put("; charset=");
 cb.put(enc);

これらは、次の一文に置き換えられます。

 cb.put("text/").put(subtype).put("; charset=").put(enc);

導入されたバージョン:

1.4

メソッドの概要

static CharBuffer	allocate(int capacity) 新しい char バッファを割り当てます。
char[]	array() 現在のバッファを補助する char 配列を返します (オプション)。
int	arrayOffset() 現在のバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します (オプション)。
abstract CharBuffer	asReadOnlyBuffer() 現在のバッファのコンテンツを共有する新しい読み込み専用文字列バッファを作成します。
char	charAt(int index) 現在位置からの相対位置で表される指定されたインデックス位置にある文字を読み込みます。
abstract CharBuffer	compact() 現在のバッファを圧縮します (オプション)。
int	compareTo(Object ob) 現在のバッファを別のオブジェクトと比較します。
abstract CharBuffer	duplicate() 現在のバッファのコンテンツを共有する新しい char バッファを作成します。
boolean	equals(Object ob) 現在のバッファが別のオブジェクトと等価であるかどうかを判断します。
abstract char	get() 相対「get」メソッドです。
CharBuffer	get(char[] dst) 相対「一括get」メソッドです。
CharBuffer	get(char[] dst, int offset, int length) 相対「一括get」メソッドです。
abstract char	get(int index) 絶対「get」メソッドです。
boolean	hasArray() 現在のバッファがアクセス可能な char 配列を利用するかどうかを判断します。
int	hashCode() 現在のバッファの現在のハッシュコードを返します。
abstract boolean	isDirect() 現在のバッファがダイレクトバッファであるかどうかを判断します。
int	length() 現在の char バッファのバッファ長を返します。
abstract ByteOrder	order() 現在のバッファのバイト順序を取得します。
abstract CharBuffer	put(char c) 相対「put」メソッドです (オプション)。
CharBuffer	put(char[] src) 相対「一括put」メソッドです (オプション)。
CharBuffer	put(char[] src, int offset, int length) 相対「一括put」メソッドです (オプション)。
CharBuffer	put(CharBuffer src) 相対「一括put」メソッドです (オプション)。
abstract CharBuffer	put(int index, char c) 絶対「put」メソッドです (オプション)。
CharBuffer	put(String src) 相対「一括put」メソッドです (オプション)。
CharBuffer	put(String src, int start, int end) 相対「一括put」メソッドです (オプション)。
abstract CharBuffer	slice() 現在のバッファのコンテンツの共有のサブシーケンスをコンテンツとする新しい char バッファを作成します。
abstract CharSequence	subSequence(int start, int end) 現在のバッファの指定されたサブシーケンス (現在位置からの相対位置) を表す新しい char バッファを作成します。
String	toString() 現在のバッファ内に残っている文字を含む文字列を返します。
static CharBuffer	wrap(char[] array) char 配列をバッファにラップします。
static CharBuffer	wrap(char[] array, int offset, int length) char 配列をバッファにラップします。
static CharBuffer	wrap(CharSequence csq) 文字列をバッファにラップします。
static CharBuffer	wrap(CharSequence csq, int start, int end) 文字シーケンスをバッファにラップします。

クラス java.nio.Buffer から継承したメソッド

capacity, clear, flip, hasRemaining, isReadOnly, limit, limit, mark, position, position, remaining, reset, rewind

クラス java.lang.Object から継承したメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

メソッドの詳細

allocate

public static CharBuffer allocate(int capacity)

新しい char バッファを割り当てます。

新しいバッファの位置は 0、リミットは容量と同じ値になります。マークは定義されません。このバッファは補助配列を利用することになっており、その配列オフセットは 0 です。

パラメータ:

capacity - 新しいバッファの容量 (文字数)

戻り値:

新しい char バッファ

wrap

public static CharBuffer wrap(char[] array,
                              int offset,
                              int length)

char 配列をバッファにラップします。

新しいバッファは指定された char 配列を利用します。バッファに変更を加えると char 配列が変更され、char 配列に変更を加えるとバッファが変更されます。新しいバッファの容量は array.length、位置は offset、リミットは offset + length になります。マークは定義されません。指定された配列が補助配列となり、その{@link #arrayOffset 配列オフセットは 0 になります。

パラメータ:

array - 新しいバッファを補助する配列

offset - 使用するサブ配列のオフセット。array.length 以下の正の数でなければならない。新しいバッファの位置は、この値に設定される

length - 使用するサブ配列のオフセット。array.length - offset 以下の正の数でなければならない。新しいバッファのリミットは、offset + length に設定される

戻り値:

新しい char バッファ

例外:

IndexOutOfBoundsException - offset パラメータと length パラメータの前提条件が満たされていない場合

wrap

public static CharBuffer wrap(char[] array)

char 配列をバッファにラップします。

新しいバッファは指定された char 配列を利用します。バッファに変更を加えると char 配列が変更され、char 配列に変更を加えるとバッファが変更されます。新しいバッファの容量とリミットは array.length、位置は 0 になります。マークは定義されません。指定された配列が補助配列となり、その{@link #arrayOffset 配列オフセットは 0 になります。

パラメータ:

array - 現在のバッファを補助する配列

戻り値:

新しい char バッファ

wrap

public static CharBuffer wrap(CharSequence csq,
                              int start,
                              int end)

文字シーケンスをバッファにラップします。

新しい読み込み専用バッファのコンテンツは、指定された文字シーケンスのコンテンツになります。バッファの容量は csq.length()、位置は start、リミットは end になります。マークは定義されません。

パラメータ:

csq - 作成される新しい char バッファの元になる文字シーケンス

start - 使用される最初の文字を示すインデックス。csq.length() 以下の正の数でなければならない。新しいバッファの位置は、この値に設定される

end - 使用される最後の文字の次の文字を示すインデックス。start 以上 csq.length() 以下の正の数でなければならない。新しいバッファのリミットは、この値に設定される

戻り値:

新しい char バッファ

例外:

IndexOutOfBoundsException - start パラメータと end パラメータの前提条件が満たされていない場合

wrap

public static CharBuffer wrap(CharSequence csq)

文字列をバッファにラップします。

新しい読み込み専用バッファのコンテンツは、指定された文字列のコンテンツになります。新しいバッファの容量とリミットは csq.length()、位置は 0 になります。マークは定義されません。

パラメータ:

csq - 作成される新しい char バッファの元になる文字シーケンス

戻り値:

新しい char バッファ

slice

public abstract CharBuffer slice()

現在のバッファのコンテンツの共有のサブシーケンスをコンテンツとする新しい char バッファを作成します。

新しいバッファのコンテンツは、現在のバッファの現在位置から始まります。現在のバッファのコンテンツに変更を加えると、その内容が新しいバッファに反映されます。新しいバッファのコンテンツに変更を加えると、その内容が現在のバッファに反映されます。2 つのバッファの位置、リミット、マークの値はそれぞれ異なります。

新しいバッファの位置は 0、容量とリミットは現在のバッファ内に残っている文字数になります。マークは定義されません。新しいバッファは、現在のバッファがダイレクトバッファである場合にかぎりダイレクトバッファになります。また、現在のバッファが読み込み専用バッファである場合にかぎり読み込み専用バッファになります。

戻り値:

新しい char バッファ

duplicate

public abstract CharBuffer duplicate()

現在のバッファのコンテンツを共有する新しい char バッファを作成します。

新しいバッファのコンテンツは、現在のバッファのコンテンツと同じになります。現在のバッファのコンテンツに変更を加えると、その内容が新しいバッファに反映されます。新しいバッファのコンテンツに変更を加えると、その内容が現在のバッファに反映されます。2 つのバッファの位置、リミット、マークの値はそれぞれ異なります。

新しいバッファの容量、リミット、位置、マークの値は、現在のバッファの対応する値と同じになります。新しいバッファは、現在のバッファがダイレクトバッファである場合にかぎりダイレクトバッファになります。また、現在のバッファが読み込み専用バッファである場合にかぎり読み込み専用バッファになります。

戻り値:

新しい char バッファ

asReadOnlyBuffer

public abstract CharBuffer asReadOnlyBuffer()

現在のバッファのコンテンツを共有する新しい読み込み専用文字列バッファを作成します。

新しいバッファのコンテンツは、現在のバッファのコンテンツと同じになります。現在のバッファのコンテンツに変更を加えると、その内容が新しいバッファに反映されます。しかし、新しいバッファ自体は読み込み専用であり、その共有コンテンツを変更することはできません。2 つのバッファの位置、リミット、マークの値はそれぞれ異なります。

新しいバッファの容量、リミット、位置、マークの値は、現在のバッファの対応する値と同じになります。

現在のバッファが読み込み専用の場合、このメソッドの動作は(duplicate) メソッドとまったく同じになります。

戻り値:

新しい読み込み専用文字列バッファ

get

public abstract char get()

相対「get」メソッドです。現在のバッファの現在位置の文字を読み込み、位置を増加します。

戻り値:

バッファの現在位置の文字

例外:

BufferUnderflowException - バッファの現在位置がリミット以上である場合

put

public abstract CharBuffer put(char c)

相対「put」メソッドです (オプション)。

現在のバッファの現在位置に指定された文字を書き込み、位置を増加します。

パラメータ:

c - 書き込まれる文字

戻り値:

現在のバッファ

例外:

BufferOverflowException - 現在のバッファの現在位置がリミット以上である場合

ReadOnlyBufferException - 現在のバッファが読み込み専用バッファである場合

get

public abstract char get(int index)

絶対「get」メソッドです。指定されたインデックス位置の文字を読み込みます。

パラメータ:

index - 文字の読み込み位置を示すインデックス

戻り値:

指定されたインデックス位置の文字

例外:

IndexOutOfBoundsException - index が負の数である場合、またはバッファのリミット以上である場合

put

public abstract CharBuffer put(int index,
                               char c)

絶対「put」メソッドです (オプション)。

現在のバッファの指定されたインデックス位置に指定された文字を書き込みます。

パラメータ:

index - 文字の書き込み先を示すインデックス

c - 書き込まれる文字

戻り値:

現在のバッファ

例外:

IndexOutOfBoundsException - index が負の数である場合、またはバッファのリミット以上である場合

ReadOnlyBufferException - 現在のバッファが読み込み専用バッファである場合

get

public CharBuffer get(char[] dst,
                      int offset,
                      int length)

相対「一括get」メソッドです。

このメソッドは、現在のバッファから指定された配列に文字を転送します。現在のバッファ内に残っている文字数が要求に満たない場合 (length > remaining())、文字は一切転送されず、BufferUnderflowException がスローされます。

それ以外の場合、このメソッドは、現在のバッファの現在位置から length 文字を指定された配列の指定されたオフセット位置へコピーします。そのたびに、現在のバッファの位置が length ずつ増加します。

このメソッドを src.get(dst, off, len) の形式で呼び出すと、以下のループとまったく同じ結果になります。

     for (int i = off; i < off + len; i++)
         dst[i] = src.get(); 

ただし、現在のバッファ内に残っている文字数が十分であることを最初に確認する動作は、このメソッド固有です。また、このメソッドのほうがループよりも効率的です。

パラメータ:

dst - 文字の書き込み先となる配列

offset - 最後の文字の書き込み先となる配列内のオフセット。dst.length 以下の正の数でなければならない

length - 指定された配列に書き込まれる最大文字数。dst.length - offset 以下の正の数でなければならない

戻り値:

現在のバッファ

例外:

BufferUnderflowException - 現在のバッファ内に残っている文字数が length よりも少ない場合

IndexOutOfBoundsException - offset パラメータと length パラメータの前提条件が満たされていない場合

get

public CharBuffer get(char[] dst)

相対「一括get」メソッドです。

このメソッドは、現在のバッファから指定された配列へ文字を転送します。このメソッドを src.get(a) の形式で呼び出すと、以下の呼び出しと同じ結果になります。

     src.get(a, 0, a.length) 

戻り値:

現在のバッファ

例外:

BufferUnderflowException - 現在のバッファ内に残っている文字数が length よりも少ない場合

put

public CharBuffer put(CharBuffer src)

相対「一括put」メソッドです (オプション)。

このメソッドは、指定されたソースバッファ内に残っている文字を現在のバッファへ転送します。ソースバッファ内に残っている文字数が現在のバッファ内に残っている文字数よりも多い場合 (src.remaining() > remaining())、文字は一切転送されず、BufferOverflowException がスローされます。

それ以外の場合、このメソッドは、指定されたバッファの現在位置から現在のバッファの現在位置へ n = src.remaining() 文字をコピーします。そのたびに、両方のバッファの位置が n ずつ増加します。

このメソッドを dst.put(src) の形式で呼び出すと、以下のループとまったく同じ結果になります。

     while (src.hasRemaining())
         dst.put(src.get()); 

ただし、現在のバッファ内に十分な容量があることを最初に確認する動作は、このメソッドに固有です。また、このメソッドのほうがループよりもずっと効率的です。

パラメータ:

src - 文字が読み込まれるソースバッファ (現在のバッファ以外)

戻り値:

現在のバッファ

例外:

BufferOverflowException - 現在のバッファに、ソースバッファの文字を格納できるだけの容量がない場合

IllegalArgumentException - ソースバッファとして現在のバッファを指定した場合

ReadOnlyBufferException - 現在のバッファが読み込み専用バッファである場合

put

public CharBuffer put(char[] src,
                      int offset,
                      int length)

相対「一括put」メソッドです (オプション)。

このメソッドは、指定されたソース配列から現在のバッファへ文字を転送します。配列からコピーする文字数が現在のバッファ内に残っている文字数より多い場合 (length > remaining())、文字は一切転送されず、BufferOverflowException がスローされます。

それ以外の場合、このメソッドは、指定された配列の指定されたオフセット位置から現在のバッファの現在位置へ length 文字をコピーします。そのたびに、現在のバッファの位置が length ずつ増加します。

このメソッドを dst.put(src, off, len) の形式で呼び出すと、以下のループとまったく同じ結果になります。

     for (int i = off; i < off + len; i++)
         dst.put(a[i]); 

ただし、現在のバッファ内に十分な容量があることを最初に確認する動作は、このメソッドに固有です。また、このメソッドのほうがループよりもずっと効率的です。

パラメータ:

offset - 最初の文字が読み込まれる配列内のオフセット。array.length 以下の正の数でなければならない

length - 指定された配列から読み取られる文字数。array.length - offset 以下の正の数でなければならない

戻り値:

現在のバッファ

例外:

BufferOverflowException - 現在のバッファ内に残っている容量が不足している場合

IndexOutOfBoundsException - offset パラメータと length パラメータの前提条件が満たされていない場合

ReadOnlyBufferException - 現在のバッファが読み込み専用バッファである場合

put

public final CharBuffer put(char[] src)

相対「一括put」メソッドです (オプション)。

このメソッドは、ソースとなる指定された char 配列のコンテンツ全体を現在のバッファへ転送します。このメソッドを dst.put(a) の形式で呼び出すと、以下の呼び出しと同じ結果になります。

     dst.put(a, 0, a.length) 

戻り値:

現在のバッファ

例外:

BufferOverflowException - 現在のバッファ内に残っている容量が不足している場合

ReadOnlyBufferException - 現在のバッファが読み込み専用バッファである場合

put

public CharBuffer put(String src,
                      int start,
                      int end)

相対「一括put」メソッドです (オプション)。

このメソッドは、指定された文字列から現在のバッファへ文字を転送します。文字列からコピーする文字数が現在のバッファ内に残っている文字数より多い場合 (end - start > remaining())、文字は一切転送されず、BufferOverflowException がスローされます。

それ以外の場合、このメソッドは、指定された文字列の start インデックスから現在のバッファの現在位置へ n = end - start 文字をコピーします。そのたびに、現在のバッファの位置が n ずつ増加します。

このメソッドを dst.put(src, start, end) の形式で呼び出すと、以下のループとまったく同じ結果になります。

     for (int i = start; i < end; i++)
         dst.put(src.charAt(i)); 

ただし、現在のバッファ内に十分な容量があることを最初に確認する動作は、このメソッドに固有です。また、このメソッドのほうがループよりもずっと効率的です。

パラメータ:

start - 最初の文字が読み込まれる文字列内のオフセット。string.length 以下の正の数でなければならない

end - 最初の文字が読み込まれる文字列内のオフセット + 1。string.length 以下の正の数でなければならない

戻り値:

現在のバッファ

例外:

BufferOverflowException - 現在のバッファ内に残っている容量が不足している場合

IndexOutOfBoundsException - start パラメータと end パラメータの前提条件が満たされていない場合

ReadOnlyBufferException - 現在のバッファが読み込み専用バッファである場合

put

public final CharBuffer put(String src)

相対「一括put」メソッドです (オプション)。

このメソッドは、指定されたソース文字列のコンテンツ全体を現在のバッファへ転送します。このメソッドを dst.put(s) の形式で呼び出すと、以下の呼び出しと同じ結果になります。

     dst.put(s, 0, s.length()) 

戻り値:

現在のバッファ

例外:

BufferOverflowException - 現在のバッファ内に残っている容量が不足している場合

ReadOnlyBufferException - 現在のバッファが読み込み専用バッファである場合

hasArray

public final boolean hasArray()

現在のバッファがアクセス可能な char 配列を利用するかどうかを判断します。

このメソッドの戻り値が true であれば、array メソッドと arrayOffset メソッドを安全に呼び出すことができます。

戻り値:

現在のバッファが配列を利用しており、読み込み専用でない場合にかぎり true

array

public final char[] array()

現在のバッファを補助する char 配列を返します (オプション)。

現在のバッファのコンテンツに変更を加えると、返される配列のコンテンツも変更されます。その逆も同様です。

このメソッドを呼び出す前に hasArray メソッドを呼び出し、現在のバッファがアクセス可能な補助配列を持っていることを確認します。

戻り値:

現在のバッファを補助する配列

例外:

ReadOnlyBufferException - 現在のバッファが配列を利用し、しかも読み込み専用である場合

UnsupportedOperationException - 現在のバッファがアクセス可能な配列を利用しない場合

arrayOffset

public final int arrayOffset()

現在のバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します (オプション)。

現在のバッファが配列を利用していれば、その位置 p が配列のインデックス p + arrayOffset() と一致します。

このメソッドを呼び出す前に hasArray メソッドを呼び出し、現在のバッファがアクセス可能な補助配列を持っていることを確認します。

戻り値:

現在のバッファの配列内にある、このバッファの最初の要素のオフセット

例外:

ReadOnlyBufferException - 現在のバッファが配列を利用し、しかも読み込み専用である場合

UnsupportedOperationException - 現在のバッファがアクセス可能な配列を利用しない場合

compact

public abstract CharBuffer compact()

現在のバッファを圧縮します (オプション)。

バッファの現在位置からリミットまでの間に文字が存在する場合、これらをバッファの先頭にコピーします。つまり、インデックス位置 p = position() の文字がインデックス 0 にコピーされ、インデックス位置 p + 1 の文字がインデックス 1 にコピーされるということです。インデックス位置 limit() - 1 の文字がインデックス n = limit() - 1 - p にコピーされるまで、同様の処理が繰り返されます。最終的にバッファの位置は n に設定され、リミットは容量の値と等しくなります。マークは破棄されます。

バッファの位置は、0 ではなく、コピーされる文字数と等しくなります。したがって、このメソッドを呼び出したあと、すぐに別の相対「put」メソッドを呼び出すことができます。

戻り値:

現在のバッファ

例外:

ReadOnlyBufferException - 現在のバッファが読み込み専用バッファである場合

isDirect

public abstract boolean isDirect()

現在のバッファがダイレクトバッファであるかどうかを判断します。

戻り値:

現在のバッファがダイレクトバッファである場合にかぎり true

hashCode

public int hashCode()

現在のバッファの現在のハッシュコードを返します。

char バッファのハッシュコードは、バッファ内に残っている要素、すなわち position() 〜 limit() - 1 の要素だけに依存します。

バッファのハッシュコードはコンテンツ依存型です。今後バッファのコンテンツが変更されないことが明らかでないかぎり、バッファをハッシュマップその他のデータ構造のキーとして使用することは避けてください。

オーバーライド:

クラス Object 内の hashCode

戻り値:

現在のバッファの現在のハッシュコード

関連項目:

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object ob)

現在のバッファが別のオブジェクトと等価であるかどうかを判断します。

2 つの char バッファは、次の場合にかぎり等価です。

1. 要素の型が同じである

2. 残りの要素数が同じである

3. 残りの要素のシーケンス (開始位置とは無関係) が各点で等しい

char バッファが、その他の型のオブジェクトと等価になることはありません。

オーバーライド:

クラス Object 内の equals

パラメータ:

ob - 現在のバッファと比較するオブジェクト

戻り値:

現在のバッファが指定されたオブジェクトと等価である場合にかぎり true

関連項目:

Object.hashCode(), Hashtable

compareTo

public int compareTo(Object ob)

現在のバッファを別のオブジェクトと比較します。

2 つの char バッファを比較する際は、残りの要素のシーケンスが辞書順に比較されます。このとき、双方のバッファ内に残っている各シーケンスの開始位置は考慮されません。

char バッファとその他の型のオブジェクトを比較することはできません。

定義:

インタフェース Comparable 内の compareTo

パラメータ:

ob - 比較対象の Object

戻り値:

現在のバッファがもう一方のバッファより小さい場合は負の整数、等しい場合は 0、大きい場合は正の整数

例外:

ClassCastException - 引数が char バッファではない場合

toString

public String toString()

現在のバッファ内に残っている文字を含む文字列を返します。

返される文字列の最初の文字は、現在のバッファの現在位置にある文字になります。また、返される文字列の最後の文字は、インデックス位置 limit() - 1 にある文字列になります。このメソッドを呼び出しても、バッファの現在位置は変わりません。

定義:

インタフェース CharSequence 内の toString

オーバーライド:

クラス Object 内の toString

戻り値:

指定された文字列

length

public final int length()

現在の char バッファのバッファ長を返します。

文字シーケンスとして見た場合、char バッファのバッファ長 (文字数) は、位置の値以上、リミットの値より小さい値になります。この値は remaining() と等価です。

定義:

インタフェース CharSequence 内の length

戻り値:

現在の char バッファのバッファ長

charAt

public final char charAt(int index)

現在位置からの相対位置で表される指定されたインデックス位置にある文字を読み込みます。

定義:

インタフェース CharSequence 内の charAt

パラメータ:

index - 読み取られる文字のインデックスは現在位置からの相対位置で表される。この値は remaining() 以下の正の数でなければならない

戻り値:

インデックス位置 position() + index にある文字

例外:

IndexOutOfBoundsException - index の前提条件が満たされていない場合

subSequence

public abstract CharSequence subSequence(int start,
                                         int end)

現在のバッファの指定されたサブシーケンス (現在位置からの相対位置) を表す新しい char バッファを作成します。

新しいバッファは、現在のバッファのコンテンツを共有します。つまり、現在のバッファのコンテンツが変更可能である場合、一方のバッファに変更を加えるともう一方のバッファも変更されます。新しいバッファの容量は現在のバッファの容量と同じになります。新しいバッファの位置は position() + start、リミットは position() + end になります。新しいバッファは、現在のバッファがダイレクトバッファである場合にかぎりダイレクトバッファになります。また、現在のバッファが読み込み専用である場合にかぎり読み込み専用バッファになります。

定義:

インタフェース CharSequence 内の subSequence

パラメータ:

start - サブシーケンス内の最初の文字を示すインデックス (現在位置からの相対位置)。remaining() 以下の正の数でなければならない

end - サブシーケンス内の最後の文字を示すインデックス (現在位置からの相対位置)。start 以上 remaining() 以下の値でなければならない

戻り値:

新しい char バッファ

例外:

IndexOutOfBoundsException - start パラメータと end パラメータの前提条件が満たされていない場合

order

public abstract ByteOrder order()

現在のバッファのバイト順序を取得します。

既存の char 配列の割り当てまたはラップによって作成された char バッファのバイト順序は、基準となるハードウェアのネイティブのバイト順序と同じになります。byte バッファの ビューとして作成された char バッファのバイト順序は、ビューを作成した時点の byte バッファのバイト順序と同じになります。

戻り値:

現在のバッファのバイト順序