Class IntegerStack

Method Details

• capacity

  public final int capacity()

  Description copied from interface: PrimitiveStack

  Returns this stack's current capacity.

  The capacity may grow with a put operation w/ insufficient PrimitiveStack.remaining() elements left, if PrimitiveStack.getGrowSize() > 0.

  Specified by:

  capacity in interface PrimitiveStack

• position

  public final int position()

  Description copied from interface: PrimitiveStack

  Returns the current position of this stack.

  Position is in the range: 0 ≤ position < PrimitiveStack.capacity().

  The position equals to the number of elements stored.

  Specified by:

  position in interface PrimitiveStack

• position

  public final void position(int newPosition) throws IndexOutOfBoundsException

  Description copied from interface: PrimitiveStack

  Sets the position of this stack.

  Specified by:

  position in interface PrimitiveStack

  Parameters:

  newPosition - the new position

  Throws:

  IndexOutOfBoundsException - if newPosition is outside of range: 0 ≤ position < PrimitiveStack.capacity().

• remaining

  public final int remaining()

  Description copied from interface: PrimitiveStack

  Returns the remaining elements left before stack will grow about PrimitiveStack.getGrowSize().

     remaining := capacity() - position();
   

  0 denotes a full stack.

  Specified by:

  remaining in interface PrimitiveStack

  See Also:

  • PrimitiveStack.capacity()
  • PrimitiveStack.position()

• getGrowSize

  public final int getGrowSize()

  Description copied from interface: PrimitiveStack

  Returns the grow size. A stack grows by this size in case a put operation exceeds it's PrimitiveStack.capacity().

  Specified by:

  getGrowSize in interface PrimitiveStack

• setGrowSize

  public final void setGrowSize(int newGrowSize)

  Description copied from interface: PrimitiveStack

  Set new {@link #growSize().

  Specified by:

  setGrowSize in interface PrimitiveStack

• toString

  public final String toString()

  Overrides:

  toString in class Object

• buffer

  public final int[] buffer()

• putOnTop

  public final int[] putOnTop(int[] src, int srcOffset, int length) throws IndexOutOfBoundsException

  FILO put operation

  Parameters:

  src - source buffer

  srcOffset - offset of src

  length - number of float elements to put from src on-top this stack

  Returns:

  the src float[]

  Throws:

  IndexOutOfBoundsException - if stack cannot grow due to zero grow-size or offset+length exceeds src.

• putOnTop

  public final IntBuffer putOnTop(IntBuffer src, int length) throws IndexOutOfBoundsException, BufferUnderflowException

  FILO put operation

  Parameters:

  src - source buffer, it's position is incremented by length

  length - number of float elements to put from src on-top this stack

  Returns:

  the src FloatBuffer

  Throws:

  IndexOutOfBoundsException - if stack cannot grow due to zero grow-size

  BufferUnderflowException - if src FloatBuffer has less remaining elements than length.

• getFromTop

  public final int[] getFromTop(int[] dest, int destOffset, int length) throws IndexOutOfBoundsException

  FILO get operation

  Parameters:

  dest - destination buffer

  destOffset - offset of dest

  length - number of float elements to get from-top this stack to dest.

  Returns:

  the dest float[]

  Throws:

  IndexOutOfBoundsException - if stack or dest has less elements than length.

• getFromTop

  public final IntBuffer getFromTop(IntBuffer dest, int length) throws IndexOutOfBoundsException, BufferOverflowException

  FILO get operation

  Parameters:

  dest - destination buffer, it's position is incremented by length.

  length - number of float elements to get from-top this stack to dest.

  Returns:

  the dest FloatBuffer

  Throws:

  IndexOutOfBoundsException - if stack has less elements than length

  BufferOverflowException - if src FloatBuffer has less remaining elements than length.