Buffer (langx-java 3.2.2 API)

java.lang.Object
- com.jn.langx.util.collection.buffer.Buffer

直接已知子类:: ArrayBuffer

public abstract class Buffer
extends Object

构造器概要

构造器
构造器和说明

Buffer(int mark, int pos, int lim, int cap)

构造器
构造器和说明
`Buffer(int mark, int pos, int lim, int cap)`

方法概要

所有方法实例方法抽象方法具体方法
限定符和类型	方法和说明
`abstract Object`	`array()` Returns the array that backs this buffer (optional operation).
`abstract int`	`arrayOffset()` Returns the offset within this buffer's backing array of the first element of the buffer (optional operation).
`int`	`capacity()` Returns this buffer's capacity.
`Buffer`	`clear()` Clears this buffer.
`Buffer`	`flip()` Flips this buffer.
`abstract boolean`	`hasArray()` Tells whether or not this buffer is backed by an accessible array.
`boolean`	`hasRemaining()` Tells whether there are any elements between the current position and the limit.
`abstract boolean`	`isReadOnly()` Tells whether or not this buffer is read-only.
`int`	`limit()` Returns this buffer's limit.
`Buffer`	`limit(int newLimit)` Sets this buffer's limit.
`Buffer`	`mark()` Sets this buffer's mark at its position.
`int`	`position()` Returns this buffer's position.
`Buffer`	`position(int newPosition)` Sets this buffer's position.
`int`	`remaining()` Returns the number of elements between the current position and the limit.
`Buffer`	`reset()` Resets this buffer's position to the previously-marked position.
`Buffer`	`rewind()` Rewinds this buffer.

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

- 构造器详细资料
  - Buffer
```
public Buffer(int mark,
              int pos,
              int lim,
              int cap)
```
- 方法详细资料
  - capacity
```
public final int capacity()
```
    Returns this buffer's capacity.
    
    返回:
    
    The capacity of this buffer
  - position
```
public final int position()
```
    Returns this buffer's position.
    
    返回:
    
    The position of this buffer
  - position
```
public final Buffer position(int newPosition)
```
    Sets this buffer's position. If the mark is defined and larger than the new position then it is discarded.
    
    参数:
    
    newPosition - The new position value; must be non-negative and no larger than the current limit
    
    返回:
    
    This buffer
    
    抛出:
    
    IllegalArgumentException - If the preconditions on newPosition do not hold
  - limit
```
public final int limit()
```
    Returns this buffer's limit.
    
    返回:
    
    The limit of this buffer
  - limit
```
public final Buffer limit(int newLimit)
```
    Sets this buffer's limit. If the position is larger than the new limit then it is set to the new limit. If the mark is defined and larger than the new limit then it is discarded.
    
    参数:
    
    newLimit - The new limit value; must be non-negative and no larger than this buffer's capacity
    
    返回:
    
    This buffer
    
    抛出:
    
    IllegalArgumentException - If the preconditions on newLimit do not hold
  - mark
```
public final Buffer mark()
```
    Sets this buffer's mark at its position.
    
    返回:
    
    This buffer
  - reset
```
public final Buffer reset()
```
    Resets this buffer's position to the previously-marked position.
    Invoking this method neither changes nor discards the mark's value.
    
    返回:
    
    This buffer
    
    抛出:
    
    InvalidMarkException - If the mark has not been set
  - clear
```
public final Buffer clear()
```
    Clears this buffer. The position is set to zero, the limit is set to the capacity, and the mark is discarded.
    Invoke this method before using a sequence of channel-read or put operations to fill this buffer. For example:
    buf.clear(); // Prepare buffer for reading in.read(buf); // Read data
    This method does not actually erase the data in the buffer, but it is named as if it did because it will most often be used in situations in which that might as well be the case.
    返回:
    
    This buffer
  - flip
```
public final Buffer flip()
```
    Flips this buffer. The limit is set to the current position and then the position is set to zero. If the mark is defined then it is discarded.
    After a sequence of channel-read or put operations, invoke this method to prepare for a sequence of channel-write or relative get operations. For example:
    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
    This method is often used in conjunction with method when transferring data from one place to another.
    返回:
    
    This buffer
  - rewind
```
public final Buffer rewind()
```
    Rewinds this buffer. The position is set to zero and the mark is discarded.
    Invoke this method before a sequence of channel-write or get operations, assuming that the limit has already been set appropriately. For example:
    out.write(buf); // Write remaining data buf.rewind(); // Rewind buffer buf.get(array); // Copy data into array
    返回:
    
    This buffer
  - remaining
```
public final int remaining()
```
    Returns the number of elements between the current position and the limit.
    
    返回:
    
    The number of elements remaining in this buffer
  - hasRemaining
```
public final boolean hasRemaining()
```
    Tells whether there are any elements between the current position and the limit.
    
    返回:
    
    true if, and only if, there is at least one element remaining in this buffer
  - isReadOnly
```
public abstract boolean isReadOnly()
```
    Tells whether or not this buffer is read-only.
    
    返回:
    
    true if, and only if, this buffer is read-only
  - hasArray
```
public abstract boolean hasArray()
```
    Tells whether or not this buffer is backed by an accessible array.
    If this method returns true then the array and arrayOffset methods may safely be invoked.
    
    返回:
    
    true if, and only if, this buffer is backed by an array and is not read-only
    
    从以下版本开始:
    
    2.10.6
  - array
```
public abstract Object array()
```
    Returns the array that backs this buffer (optional operation).
    This method is intended to allow array-backed buffers to be passed to native code more efficiently. Concrete subclasses provide more strongly-typed return values for this method.
    Modifications to this buffer's content will cause the returned array's content to be modified, and vice versa.
    Invoke the hasArray method before invoking this method in order to ensure that this buffer has an accessible backing array.
    
    返回:
    
    The array that backs this buffer
    
    抛出:
    
    ReadOnlyBufferException - If this buffer is backed by an array but is read-only
    
    UnsupportedOperationException - If this buffer is not backed by an accessible array
    
    从以下版本开始:
    
    2.10.6
  - arrayOffset
```
public abstract int arrayOffset()
```
    Returns the offset within this buffer's backing array of the first element of the buffer (optional operation).
    If this buffer is backed by an array then buffer position p corresponds to array index p + arrayOffset().
    Invoke the hasArray method before invoking this method in order to ensure that this buffer has an accessible backing array.
    
    返回:
    
    The offset within this buffer's array of the first element of the buffer
    
    抛出:
    
    ReadOnlyBufferException - If this buffer is backed by an array but is read-only
    
    UnsupportedOperationException - If this buffer is not backed by an accessible array
    
    从以下版本开始:
    
    2.10.6

类 Buffer

构造器概要

方法概要

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

构造器详细资料

Buffer

方法详细资料

capacity

position

position

limit

limit

mark

reset

clear

flip

rewind

remaining

hasRemaining

isReadOnly

hasArray

array

arrayOffset