Класс CharBuffer

public static CharBuffer allocate(int capacity)

Параметры:

capacity — ёмкость нового буфера в символах

Возвращает:

Новый буфер char

Исключения:

IllegalArgumentException — если ёмкость — отрицательное число

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

Параметры:

array — массив, который будет поддерживать новый буфер

offset — смещение подмассива для использования; должно быть неотрицательным и не превышать array.length. Позиция нового буфера будет установлена в это значение.

length — длина подмассива для использования; должна быть неотрицательной и не превышать array.length - offset. Предел нового буфера будет установлен в offset + length.

Возвращает:

Новый буфер char

Исключения:

IndexOutOfBoundsException — если условия для параметров offset и length не соблюдены

public static CharBuffer wrap(char[] array)

Параметры:

array — массив, который будет поддерживать этот буфер

Возвращает:

Новый буфер char

public int read(CharBuffer target) throws IOException

Определено в:

read в интерфейсе Readable

Параметры:

target — буфер для чтения символов

Возвращает:

Количество символов, добавленных в буфер, возможно ноль, или -1, если этот источник символов достиг конца

Исключения:

IOException — если произошла ошибка ввода-вывода

ReadOnlyBufferException — если целевой буфер является только для чтения, даже если его длина равна нулю

С:

1.5

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

Параметры:

csq — последовательность символов, из которой должен быть создан новый буфер символов

start — индекс первого символа для использования; должно быть неотрицательным и не превышать csq.length(). Позиция нового буфера будет установлена в это значение.

end — индекс символа, следующего за последним используемым символом; должно быть не меньше start и не превышать csq.length(). Предел нового буфера будет установлен в это значение.

Возвращает:

Новый буфер символов

Исключения:

IndexOutOfBoundsException — если условия для параметров start и end не соблюдены

public static CharBuffer wrap(CharSequence csq)

Параметры:

csq — последовательность символов, из которой должен быть создан новый буфер символов

Возвращает:

Новый буфер символов

public abstract CharBuffer slice()

Определено в:

slice в классе Buffer

Возвращает:

Новый буфер char

public abstract CharBuffer slice(int index, int length)

Определено в:

slice в классе Buffer

Параметры:

index — позиция в этом буфере, с которой начнётся содержимое нового буфера; должно быть неотрицательным и не превышать limit()

length — количество элементов, которое будет содержать новый буфер; должно быть неотрицательным и не превышать limit() - index

Возвращает:

Новый буфер

Исключения:

IndexOutOfBoundsException — если index отрицательное или больше limit(), length отрицательное, или length > limit() - index

С:

13

public abstract CharBuffer duplicate()

Определено в:

duplicate в классе Buffer

Возвращает:

Новый буфер char

public abstract CharBuffer asReadOnlyBuffer()

Возвращает:

Новый, только для чтения, буфер char

public abstract char get()

Возвращает:

Символ char в текущей позиции буфера

Исключения:

BufferUnderflowException — если текущая позиция буфера не меньше его предела

public abstract CharBuffer put(char c)

Параметры:

c - Записываемый символ

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если текущая позиция этого буфера не меньше его предела

ReadOnlyBufferException - Если этот буфер только для чтения

public abstract char get(int index)

Параметры:

index - Индекс, с которого будет считан символ

Возвращает:

Символ по заданному индексу

Исключения:

IndexOutOfBoundsException - Если index отрицателен или не меньше предела буфера

public abstract CharBuffer put(int index, char c)

Параметры:

index - Индекс, в который будет записан символ

c - Значение символа для записи

Возвращает:

Этот буфер

Исключения:

IndexOutOfBoundsException - Если index отрицателен или не меньше предела буфера

ReadOnlyBufferException - Если этот буфер только для чтения

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

    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 не соблюдаются

public CharBuffer get(char[] dst)

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

Параметры:

dst - Массив-приемник

Возвращает:

Этот буфер

Исключения:

BufferUnderflowException - Если оставшихся символов в этом буфере меньше, чем length

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

    for (int i = offset, j = index; i < offset + length; i++, j++)
        dst[i] = src.get(j);

Параметры:

index - Индекс в этом буфере, с которого будет считан первый символ; должен быть неотрицательным и меньше limit()

dst - Массив-приемник

offset - Смещение в массиве первого символа для записи; должно быть неотрицательным и меньше dst.length

length - Количество символов для записи в заданный массив; должно быть неотрицательным и не больше меньшего из limit() - index и dst.length - offset

Возвращает:

Этот буфер

Исключения:

IndexOutOfBoundsException - Если условия на параметры index, offset и length не соблюдаются

См. также:

13

public CharBuffer get(int index, char[] dst)

    src.get(index, dst, 0, dst.length)

Параметры:

index - Индекс в этом буфере, с которого будет считан первый символ; должен быть неотрицательным и меньше limit()

dst - Массив-приемник

Возвращает:

Этот буфер

Исключения:

IndexOutOfBoundsException - Если index отрицателен, не меньше limit() или limit() - index < dst.length

См. также:

13

public CharBuffer put(CharBuffer src)

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

Параметры:

src - Буфер-источник, из которого будут считываться символы; не должен быть этим буфером

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если в этом буфере недостаточно места для оставшихся символов в буфере-источнике

IllegalArgumentException - Если буфер-источник совпадает с этим буфером

ReadOnlyBufferException - Если этот буфер только для чтения

public CharBuffer put(int index, CharBuffer src, int offset, int length)

    for (int i = offset, j = index; i < offset + length; i++, j++)
        dst.put(j, src.get(i));

Параметры:

index - Индекс в этом буфере, в который будет записан первый символ; должен быть неотрицательным и меньше limit()

src - Буфер-источник

offset - Индекс в буфере-источнике первого символа для чтения; должен быть неотрицательным и меньше src.limit()

length - Количество символов для чтения из заданного буфера; должно быть неотрицательным и не больше меньшего из limit() - index и src.limit() - offset

Возвращает:

Этот буфер

Исключения:

IndexOutOfBoundsException - Если условия на параметры index, offset и length не соблюдаются

ReadOnlyBufferException - Если этот буфер только для чтения

См. также:

16

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

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

Параметры:

src - Массив, из которого должны считываться символы

offset - Смещение в массиве первого символа для считывания; должно быть неотрицательным и не превышать src.length

length - Количество символов, которые должны быть считываются из заданного массива; должно быть неотрицательным и не превышать src.length - offset

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если в этом буфере недостаточно места

IndexOutOfBoundsException - Если условия на параметры offset и length не соблюдаются

ReadOnlyBufferException - Если этот буфер только для чтения

public final CharBuffer put(char[] src)

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

Параметры:

src - Исходный массив

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если в этом буфере недостаточно места

ReadOnlyBufferException - Если этот буфер только для чтения

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

    for (int i = offset, j = index; i < offset + length; i++, j++)
        dst.put(j, src[i]);

Параметры:

index - Индекс в этом буфере, в котором будет записан первый символ; должен быть неотрицательным и быть меньше чем limit()

src - Массив, из которого должны считываться символы

offset - Смещение в массиве первого символа для считывания; должно быть неотрицательным и быть меньше чем src.length

length - Количество символов, которые должны быть считываются из заданного массива; должно быть неотрицательным и не превышать меньшего из limit() - index и src.length - offset

Возвращает:

Этот буфер

Исключения:

IndexOutOfBoundsException - Если условия на параметры index, offset и length не соблюдаются

ReadOnlyBufferException - Если этот буфер только для чтения

См. также:

13

public CharBuffer put(int index, char[] src)

    dst.put(index, src, 0, src.length);

Параметры:

index - Индекс в этом буфере, в котором будет записан первый символ; должен быть неотрицательным и быть меньше чем limit()

src - Массив, из которого должны считываться символы

Возвращает:

Этот буфер

Исключения:

IndexOutOfBoundsException - Если index отрицательное, не меньше чем limit() или limit() - index < src.length

ReadOnlyBufferException - Если этот буфер только для чтения

См. также:

13

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

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

Параметры:

src - Строка, из которой должны считываться символы

start - Смещение в строке первого символа для считывания; должно быть неотрицательным и не превышать string.length()

end - Смещение в строке последнего символа для считывания, плюс один; должно быть неотрицательным и не превышать string.length()

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если в этом буфере недостаточно места

IndexOutOfBoundsException - Если условия на параметры start и end не соблюдаются

ReadOnlyBufferException - Если этот буфер только для чтения

public final CharBuffer put(String src)

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

Параметры:

src - Исходная строка

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если в этом буфере недостаточно места

ReadOnlyBufferException - Если этот буфер только для чтения

public final boolean hasArray()

Унаследованно от:

hasArray в классе Buffer

Возвращает:

true, если и только если этот буфер поддерживается массивом и не является только для чтения

public final char[] array()

Унаследованно от:

array в классе Buffer

Возвращает:

Массив, поддерживающий этот буфер

Исключения:

ReadOnlyBufferException - Если этот буфер поддерживается массивом, но является только для чтения

UnsupportedOperationException - Если этот буфер не поддерживается доступным массивом

public final int arrayOffset()

Унаследованно от:

arrayOffset в классе Buffer

Возвращает:

Смещение в массиве этого буфера первого элемента буфера

Исключения:

ReadOnlyBufferException - Если этот буфер поддерживается массивом, но является только для чтения

UnsupportedOperationException - Если этот буфер не поддерживается доступным массивом

public final CharBuffer position(int newPosition)

Переопределяет:

position в классе Buffer

Параметры:

newPosition - Новое значение позиции; должно быть неотрицательным и не превышать текущего ограничения

Возвращает:

Этот буфер

См. также:

9

public final CharBuffer limit(int newLimit)

Переопределяет:

limit в классе Buffer

Параметры:

newLimit - Новое значение предела; должно быть неотрицательным и не больше емкости этого буфера

Возвращает:

Этот буфер

С:

9

public final CharBuffer mark()

Переопределяет:

mark в классе Buffer

Возвращает:

Этот буфер

С:

9

public final CharBuffer reset()

Переопределяет:

reset в классе Buffer

Возвращает:

Этот буфер

С:

9

public final CharBuffer clear()

    buf.clear();     // Prepare buffer for reading
    in.read(buf);    // Read data

Переопределяет:

clear в классе Buffer

Возвращает:

Этот буфер

С:

9

public final CharBuffer flip()

    buf.put(magic);    // Prepend header
    in.read(buf);      // Read data into rest of buffer
    buf.flip();        // Flip buffer
    out.write(buf);    // Write header + data to channel

Переопределяет:

flip в классе Buffer

Возвращает:

Этот буфер

С:

9

public final CharBuffer rewind()

    out.write(buf);    // Write remaining data
    buf.rewind();      // Rewind buffer
    buf.get(array);    // Copy data into array

Переопределяет:

rewind в классе Buffer

Возвращает:

Этот буфер

С:

9

public abstract CharBuffer compact()

Возвращает:

Этот буфер

Исключение:

ReadOnlyBufferException - Если этот буфер является только для чтения

public abstract boolean isDirect()

Определяется:

isDirect в классе Buffer

Возвращает:

true, если и только если этот буфер является прямым

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

Текущий код хэша этого буфера

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

public boolean equals(Object ob)

Переопределяет:

equals в классе Object

Параметры:

ob - Объект, с которым должен быть сравнен этот буфер

Возвращает:

true, если и только если этот буфер равен заданному объекту

См. также:

• Object.hashCode()
• HashMap

public int compareTo(CharBuffer that)

Определяется:

compareTo в интерфейсе Comparable<CharBuffer>

Параметры:

that - объект для сравнения.

Возвращает:

Отрицательное целое число, ноль или положительное целое число, так как этот буфер меньше, равен или больше заданного буфера

public int mismatch(CharBuffer that)

Параметры:

that - Символьный буфер, проверяемый на несовпадение с этим буфером

Возвращает:

Относительный индекс первого несовпадения между этим и заданным буфером, иначе -1, если несовпадения нет.

С:

11

public String toString()

Определяется:

toString в интерфейсе CharSequence

Переопределяет:

toString в классе Object

Возвращает:

Указанная строка

public final int length()

Определяется:

length в интерфейсе CharSequence

Возвращает:

Длина этого символьного буфера

public final boolean isEmpty()

Определяется:

isEmpty в интерфейсе CharSequence

Возвращает:

true, если есть 0 оставшиеся символы, иначе false

С:

15

public final char charAt(int index)

Определено в:

charAt в интерфейсе CharSequence

Параметры:

index - Индекс символа для считывания, относительно позиции; должен быть неотрицательным и меньше remaining()

Возвращает:

Символ по индексу position() + index

Исключения:

IndexOutOfBoundsException - Если условия предопределены для index не выполняются

public abstract CharBuffer subSequence(int start, int end)

Определено в:

subSequence в интерфейсе CharSequence

Параметры:

start - Индекс, относительно текущей позиции, первого символа в подпоследовательности; должен быть неотрицательным и не больше remaining()

end - Индекс, относительно текущей позиции, символа, следующего за последним символом в подпоследовательности; должен быть не меньше start и не больше remaining()

Возвращает:

Новый буфер символов

Исключения:

IndexOutOfBoundsException - Если условия предопределены для start и end не выполняются

public CharBuffer append(CharSequence csq)

    dst.put(csq.toString())

Определено в:

append в интерфейсе Appendable

Параметры:

csq - Последовательность символов для добавления. Если csq является null, то четыре символа "null" добавляются в этот буфер символов.

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если в этом буфере недостаточно места

ReadOnlyBufferException - Если этот буфер является только для чтения

С:

1.5

public CharBuffer append(CharSequence csq, int start, int end)

    dst.put(csq.subSequence(start, end).toString())

Определено в:

append в интерфейсе Appendable

Параметры:

csq - Последовательность символов, из которой будет добавлена подпоследовательность. Если csq является null, то символы будут добавлены так, как будто csq содержало четыре символа "null".

start - Индекс первого символа в подпоследовательности

end - Индекс символа, следующего за последним символом в подпоследовательности

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если в этом буфере недостаточно места

IndexOutOfBoundsException - Если start или end отрицательны, start больше end или end больше csq.length()

ReadOnlyBufferException - Если этот буфер является только для чтения

С:

1.5

public CharBuffer append(char c)

    dst.put(c)

Определено в:

append в интерфейсе Appendable

Параметры:

c - Символ (16-битовое значение) для добавления

Возвращает:

Этот буфер

Исключения:

BufferOverflowException - Если в этом буфере недостаточно места

ReadOnlyBufferException - Если этот буфер является только для чтения

С:

1.5

public abstract ByteOrder order()

Возвращает:

Порядок байтов этого буфера