A char buffer.
This class defines four categories of operations upon char buffers:
Absolute and relative get and
put methods that read and write
single chars;
Relative bulk get
methods that transfer contiguous sequences of chars from this buffer
into an array; and
Relative bulk put
methods that transfer contiguous sequences of chars from a
char array, a string, or some other char
buffer into this buffer; and
A method for compacting
a char buffer.
Char buffers can be created either by allocation, which allocates space for the buffer's
content, by wrapping an existing
char array or string into a buffer, or by creating a
view of an existing byte buffer.
Like a byte buffer, a char buffer is either direct or non-direct. A
char buffer created via the wrap methods of this class will
be non-direct. A char buffer created as a view of a byte buffer will
be direct if, and only if, the byte buffer itself is direct. Whether or not
a char buffer is direct may be determined by invoking the isDirect method.
This class implements the CharSequence interface so that
character buffers may be used wherever character sequences are accepted, for
example in the regular-expression package java.util.regex.
Methods in this class that do not otherwise have a value to return are specified to return the buffer upon which they are invoked. This allows method invocations to be chained. The sequence of statements
cb.put("text/");
cb.put(subtype);
cb.put("; charset=");
cb.put(enc);
cb.put("text/").put(subtype).put("; charset=").put(enc);extends