Класс CharBuffer

public static CharBuffer allocate(int capacity)

Параметры:

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

Возвращает:

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

Исключения:

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

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

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

public static CharBuffer wrap(char[] array)

Параметры:

array — массив, на основе которого будет создан этот буфер

Возвращает:

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

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

Возвращает:

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

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

Возвращает:

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

public abstract CharBuffer asReadOnlyBuffer()

Возвращает:

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

public abstract char get()

Возвращает:

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

Исключения:

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(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 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()

Возвращает:

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