-
- All Implemented Interfaces:
-
Appendable, CharSequence, Comparable<CharBuffer>, Readable
public abstract class CharBuffer
extends Buffer
implements Comparable<CharBuffer>, Appendable, CharSequence, Readable
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
-
MethodsA method for compacting, duplicating, andslicing 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);
can, for example, be replaced by the single statement
cb.put("text/").put(subtype).put("; charset=").put(enc);
-
Since:
- 1.4
|
-
- All Implemented Interfaces:
-
Appendable, CharSequence, Comparable<CharBuffer>, Readable
public abstract class CharBuffer
extends Buffer
implements Comparable<CharBuffer>, Appendable, CharSequence, Readable
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
-
Methods for compacting, duplicating, and slicing 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);
can, for example, be replaced by the single statement
cb.put("text/").put(subtype).put("; charset=").put(enc);
-
Since:
- 1.4
|
-
- All Implemented Interfaces:
-
Appendable, CharSequence, Comparable<CharBuffer>, Readable
public abstract class CharBuffer
extends Buffer
implements Comparable<CharBuffer>, Appendable, CharSequence, Readable
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);
can, for example, be replaced by the single statement
cb.put("text/").put(subtype).put("; charset=").put(enc);
-
Since:
- 1.4
|
|