Класс CharBuffer

public static CharBuffer allocate(int capacity)

Параметры:

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

Возвращает:

Новый буфер char

Исключения:

IllegalArgumentException — если capacity является отрицательным целым числом

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 — записываемый символ char

Возвращает:

Этот буфер

Исключения:

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

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

public abstract char get(int index)

Параметры:

index — индекс, по которому будет считан символ char

Возвращает:

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

Исключения:

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

public abstract CharBuffer put(int index, char c)

Параметры:

index — индекс, по которому будет записан символ char

c — записываемое значение char

Возвращает:

Этот буфер

Исключения:

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 — индекс в этом буфере, с которого будет считан первый символ char; должен быть неотрицательным и меньше limit()

dst — массив назначения

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

length — количество символов char для записи в указанный массив; должно быть неотрицательным и не превышать меньшее из значений 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 — индекс в этом буфере, с которого будет считан первый символ char; должен быть неотрицательным и меньше 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 — индекс в этом буфере, по которому будет записан первый символ char; должен быть неотрицательным и меньше limit()

src — буфер, из которого считываются символы

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

length — количество символов char для считывания из указанного буфера; должно быть неотрицательным и не превышать меньшее из значений 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 — индекс в этом буфере, по которому будет записан первый символ char; должен быть неотрицательным и меньше limit()

src — массив, из которого считываются символы

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

length — количество символов char для считывания из указанного массива; должно быть неотрицательным и не превышать меньшее из значений 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 — индекс в этом буфере, по которому будет записан первый символ char; должен быть неотрицательным и меньше 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(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 - Буфер byte для проверки на несовпадение с этим буфером

Возвращает:

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

Начиная с версии:

11

public void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)

    get(position() + srcBegin, dst, dstBegin, srcEnd - srcBegin)

Указано в:

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

Параметры:

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

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

dst - Массив назначения

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

Выбрасывает:

IndexOutOfBoundsException - Если не выполняются предварительные условия для параметров srcBegin, srcEnd и dstBegin

Начиная с версии:

25

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-битный символ char для добавления

Возвращает:

Этот буфер

Выбрасывает:

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

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

Начиная с версии:

1.5

public abstract ByteOrder order()

Возвращает:

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