CharArrayBuffer (langx-java 3.3.2 API)

java.lang.Object
- com.jn.langx.io.buffer.charseq.CharArrayBuffer

所有已实现的接口:

Serializable, CharSequence
```
public final class CharArrayBuffer
extends Object
implements CharSequence, Serializable
```
A resizable char array.

从以下版本开始:

2.8.7

另请参阅:

序列化表格

构造器概要

构造器
构造器和说明

CharArrayBuffer(int capacity)
Creates an instance of CharArrayBuffer with the given initial capacity.

构造器
构造器和说明
`CharArrayBuffer(int capacity)` Creates an instance of `CharArrayBuffer` with the given initial capacity.

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`append(byte[] b, int off, int len)` Appends `len` bytes to this buffer from the given source array starting at index `off`.
`void`	`append(ByteArrayBuffer b, int off, int len)` Appends `len` bytes to this buffer from the given source array starting at index `off`.
`void`	`append(char ch)` Appends `ch` char to this buffer.
`void`	`append(char[] b, int off, int len)` Appends `len` chars to this buffer from the given source array starting at index `off`.
`void`	`append(CharArrayBuffer b)` Appends all chars to this buffer from the given source buffer starting at index `0`.
`void`	`append(CharArrayBuffer b, int off, int len)` Appends `len` chars to this buffer from the given source buffer starting at index `off`.
`void`	`append(Object obj)` Appends chars of the textual representation of the given object to this buffer.
`void`	`append(String str)` Appends chars of the given string to this buffer.
`char[]`	`buffer()` Returns reference to the underlying char array.
`int`	`capacity()` Returns the current capacity.
`char`	`charAt(int i)` Returns the `char` value in this buffer at the specified index.
`void`	`clear()` Clears content of the buffer.
`void`	`ensureCapacity(int required)` Ensures that the capacity is at least equal to the specified minimum.
`int`	`indexOf(int ch)` Returns the index within this buffer of the first occurrence of the specified character, starting the search at `0` and finishing at `length()`.
`int`	`indexOf(int ch, int from, int to)` Returns the index within this buffer of the first occurrence of the specified character, starting the search at the specified `beginIndex` and finishing at `endIndex`.
`boolean`	`isEmpty()` Returns `true` if this buffer is empty, that is, its `length()` is equal to `0`.
`boolean`	`isFull()` Returns `true` if this buffer is full, that is, its `length()` is equal to its `capacity()`.
`int`	`length()` Returns the length of the buffer (char count).
`void`	`setLength(int len)` Sets the length of the buffer.
`CharSequence`	`subSequence(int beginIndex, int endIndex)`
`String`	`substring(int beginIndex, int endIndex)` Returns a substring of this buffer.
`String`	`substringTrimmed(int beginIndex, int endIndex)` Returns a substring of this buffer with leading and trailing whitespace omitted.
`char[]`	`toCharArray()` Converts the content of this buffer to an array of chars.
`String`	`toString()`

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

从接口继承的方法 java.lang.CharSequence
chars, codePoints

- 构造器详细资料
  - CharArrayBuffer
```
public CharArrayBuffer(int capacity)
```
    Creates an instance of CharArrayBuffer with the given initial capacity.
    
    参数:
    
    capacity - the capacity
- 方法详细资料
  - append
```
public void append(char[] b,
                   int off,
                   int len)
```
    Appends len chars to this buffer from the given source array starting at index off. The capacity of the buffer is increased, if necessary, to accommodate all len chars.
    
    参数:
    
    b - the chars to be appended.
    
    off - the index of the first char to append.
    
    len - the number of chars to append.
    
    抛出:
    
    IndexOutOfBoundsException - if off is out of range, len is negative, or off + len is out of range.
  - append
```
public void append(String str)
```
    Appends chars of the given string to this buffer. The capacity of the buffer is increased, if necessary, to accommodate all chars.
    
    参数:
    
    str - the string.
  - append
```
public void append(CharArrayBuffer b,
                   int off,
                   int len)
```
    Appends len chars to this buffer from the given source buffer starting at index off. The capacity of the destination buffer is increased, if necessary, to accommodate all len chars.
    
    参数:
    
    b - the source buffer to be appended.
    
    off - the index of the first char to append.
    
    len - the number of chars to append.
    
    抛出:
    
    IndexOutOfBoundsException - if off is out of range, len is negative, or off + len is out of range.
  - append
```
public void append(CharArrayBuffer b)
```
    Appends all chars to this buffer from the given source buffer starting at index 0. The capacity of the destination buffer is increased, if necessary, to accommodate all length() chars.
    
    参数:
    
    b - the source buffer to be appended.
  - append
```
public void append(char ch)
```
    Appends ch char to this buffer. The capacity of the buffer is increased, if necessary, to accommodate the additional char.
    
    参数:
    
    ch - the char to be appended.
  - append
```
public void append(byte[] b,
                   int off,
                   int len)
```
    Appends len bytes to this buffer from the given source array starting at index off. The capacity of the buffer is increased, if necessary, to accommodate all len bytes.
    The bytes are converted to chars using simple cast.
    
    参数:
    
    b - the bytes to be appended.
    
    off - the index of the first byte to append.
    
    len - the number of bytes to append.
    
    抛出:
    
    IndexOutOfBoundsException - if off is out of range, len is negative, or off + len is out of range.
  - append
```
public void append(ByteArrayBuffer b,
                   int off,
                   int len)
```
    Appends len bytes to this buffer from the given source array starting at index off. The capacity of the buffer is increased, if necessary, to accommodate all len bytes.
    The bytes are converted to chars using simple cast.
    
    参数:
    
    b - the bytes to be appended.
    
    off - the index of the first byte to append.
    
    len - the number of bytes to append.
    
    抛出:
    
    IndexOutOfBoundsException - if off is out of range, len is negative, or off + len is out of range.
  - append
```
public void append(Object obj)
```
    Appends chars of the textual representation of the given object to this buffer. The capacity of the buffer is increased, if necessary, to accommodate all chars.
    
    参数:
    
    obj - the object.
  - clear
```
public void clear()
```
    Clears content of the buffer. The underlying char array is not resized.
  - toCharArray
```
public char[] toCharArray()
```
    Converts the content of this buffer to an array of chars.
    
    返回:
    
    char array
  - charAt
```
public char charAt(int i)
```
    Returns the char value in this buffer at the specified index. The index argument must be greater than or equal to 0, and less than the length of this buffer.
    
    指定者:
    
    charAt 在接口中 CharSequence
    
    参数:
    
    i - the index of the desired char value.
    
    返回:
    
    the char value at the specified index.
    
    抛出:
    
    IndexOutOfBoundsException - if index is negative or greater than or equal to length().
  - buffer
```
public char[] buffer()
```
    Returns reference to the underlying char array.
    
    返回:
    
    the char array.
  - capacity
```
public int capacity()
```
    Returns the current capacity. The capacity is the amount of storage available for newly appended chars, beyond which an allocation will occur.
    
    返回:
    
    the current capacity
  - length
```
public int length()
```
    Returns the length of the buffer (char count).
    
    指定者:
    
    length 在接口中 CharSequence
    
    返回:
    
    the length of the buffer
  - ensureCapacity
```
public void ensureCapacity(int required)
```
    Ensures that the capacity is at least equal to the specified minimum. If the current capacity is less than the argument, then a new internal array is allocated with greater capacity. If the required argument is non-positive, this method takes no action.
    
    参数:
    
    required - the minimum required capacity.
  - setLength
```
public void setLength(int len)
```
    Sets the length of the buffer. The new length value is expected to be less than the current capacity and greater than or equal to 0.
    
    参数:
    
    len - the new length
    
    抛出:
    
    IndexOutOfBoundsException - if the len argument is greater than the current capacity of the buffer or less than 0.
  - isEmpty
```
public boolean isEmpty()
```
    Returns true if this buffer is empty, that is, its length() is equal to 0.
    
    返回:
    
    true if this buffer is empty, false otherwise.
  - isFull
```
public boolean isFull()
```
    Returns true if this buffer is full, that is, its length() is equal to its capacity().
    
    返回:
    
    true if this buffer is full, false otherwise.
  - indexOf
```
public int indexOf(int ch,
                   int from,
                   int to)
```
    Returns the index within this buffer of the first occurrence of the specified character, starting the search at the specified beginIndex and finishing at endIndex. If no such character occurs in this buffer within the specified bounds, -1 is returned.
    There is no restriction on the value of beginIndex and endIndex. If beginIndex is negative, it has the same effect as if it were zero. If endIndex is greater than length(), it has the same effect as if it were length(). If the beginIndex is greater than the endIndex, -1 is returned.
    
    参数:
    
    ch - the char to search for.
    
    from - the index to start the search from.
    
    to - the index to finish the search at.
    
    返回:
    
    the index of the first occurrence of the character in the buffer within the given bounds, or -1 if the character does not occur.
  - indexOf
```
public int indexOf(int ch)
```
    Returns the index within this buffer of the first occurrence of the specified character, starting the search at 0 and finishing at length(). If no such character occurs in this buffer within those bounds, -1 is returned.
    
    参数:
    
    ch - the char to search for.
    
    返回:
    
    the index of the first occurrence of the character in the buffer, or -1 if the character does not occur.
  - substring
```
public String substring(int beginIndex,
                        int endIndex)
```
    Returns a substring of this buffer. The substring begins at the specified beginIndex and extends to the character at index endIndex - 1.
    
    参数:
    
    beginIndex - the beginning index, inclusive.
    
    endIndex - the ending index, exclusive.
    
    返回:
    
    the specified substring.
    
    抛出:
    
    StringIndexOutOfBoundsException - if the beginIndex is negative, or endIndex is larger than the length of this buffer, or beginIndex is larger than endIndex.
  - substringTrimmed
```
public String substringTrimmed(int beginIndex,
                               int endIndex)
```
    Returns a substring of this buffer with leading and trailing whitespace omitted. The substring begins with the first non-whitespace character from beginIndex and extends to the last non-whitespace character with the index lesser than endIndex.
    
    参数:
    
    beginIndex - the beginning index, inclusive.
    
    endIndex - the ending index, exclusive.
    
    返回:
    
    the specified substring.
    
    抛出:
    
    IndexOutOfBoundsException - if the beginIndex is negative, or endIndex is larger than the length of this buffer, or beginIndex is larger than endIndex.
  - subSequence
```
public CharSequence subSequence(int beginIndex,
                                int endIndex)
```
    指定者:
    
    subSequence 在接口中 CharSequence
    
    从以下版本开始:
    
    2.8.7
  - toString
```
public String toString()
```
    指定者:
    
    toString 在接口中 CharSequence
    
    覆盖:
    
    toString 在类中 Object

类 CharArrayBuffer

构造器概要

方法概要

从类继承的方法 java.lang.Object

从接口继承的方法 java.lang.CharSequence

构造器详细资料

CharArrayBuffer

方法详细资料

append

append

append

append

append

append

append

append

clear

toCharArray

charAt

buffer

capacity

length

ensureCapacity

setLength

isEmpty

isFull

indexOf

indexOf

substring

substringTrimmed

subSequence

toString