Package com.carrotsearch.hppc

Class CharStack

java.lang.Object

com.carrotsearch.hppc.AbstractCharCollection

com.carrotsearch.hppc.CharArrayList

com.carrotsearch.hppc.CharStack

All Implemented Interfaces:

CharCollection, CharContainer, CharIndexedContainer, Preallocable, java.lang.Cloneable, java.lang.Iterable<CharCursor>, java.util.RandomAccess

@Generated(date="2024-05-16T12:00:00+0000",
           value="KTypeStack.java")
public class CharStack
extends CharArrayList

A subclass of CharArrayList adding stack-related utility methods. The top of the stack is at the CharArrayList.size() - 1 element.

Nested Class Summary

Nested classes/interfaces inherited from class com.carrotsearch.hppc.CharArrayList

CharArrayList.ValueIterator

Field Summary

Fields inherited from class com.carrotsearch.hppc.CharArrayList

buffer, elementsCount, EMPTY_ARRAY, resizer

Constructor Summary

Constructors

Constructor	Description
CharStack()	New instance with sane defaults.
CharStack(int expectedElements)	New instance with sane defaults.
CharStack(int expectedElements, ArraySizingStrategy resizer)	New instance with sane defaults.
CharStack(CharContainer container)	Create a stack by pushing all elements of another container to it.

Method Summary

Modifier and Type	Method	Description
CharStack	clone()	Clone this object.
void	discard()	Discard the top element from the stack.
void	discard(int count)	Discard an arbitrary number of elements from the top of the stack.
static CharStack	from(char... elements)	Create a stack by pushing a variable number of arguments to it.
char	peek()	Peek at the top element on the stack.
char	pop()	Remove the top element from the stack and return it.
void	push(char e1)	Adds one char to the stack.
void	push(char... elements)	Vararg-signature method for pushing elements at the top of the stack.
void	push(char[] elements, int start, int len)	Add a range of array elements to the stack.
void	push(char e1, char e2)	Adds two chars to the stack.
void	push(char e1, char e2, char e3)	Adds three chars to the stack.
void	push(char e1, char e2, char e3, char e4)	Adds four chars to the stack.
int	pushAll(CharContainer container)	Pushes all elements from another container to the top of the stack.
int	pushAll(java.lang.Iterable<? extends CharCursor> iterable)	Pushes all elements from another iterable to the top of the stack.

Methods inherited from class com.carrotsearch.hppc.CharArrayList

add, add, add, add, addAll, addAll, clear, contains, ensureBufferSpace, ensureCapacity, equalElements, equals, forEach, forEach, get, hashCode, indexOf, insert, isEmpty, iterator, lastIndexOf, release, remove, removeAll, removeAll, removeFirst, removeLast, removeRange, resize, set, size, toArray, trimToSize

Methods inherited from class com.carrotsearch.hppc.AbstractCharCollection

removeAll, retainAll, retainAll, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.carrotsearch.hppc.CharCollection

removeAll, retainAll, retainAll

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

CharStack

public CharStack()

New instance with sane defaults.

CharStack

public CharStack(int expectedElements)

New instance with sane defaults.

Parameters:

expectedElements - The expected number of elements guaranteed not to cause buffer expansion (inclusive).

CharStack

public CharStack(int expectedElements,
                 ArraySizingStrategy resizer)

New instance with sane defaults.

Parameters:

expectedElements - The expected number of elements guaranteed not to cause buffer expansion (inclusive).

resizer - Underlying buffer sizing strategy.

CharStack

public CharStack(CharContainer container)

Create a stack by pushing all elements of another container to it.

Method Detail

push

public void push(char e1)

Adds one char to the stack.

push

public void push(char e1,
                 char e2)

Adds two chars to the stack.

push

public void push(char e1,
                 char e2,
                 char e3)

Adds three chars to the stack.

push

public void push(char e1,
                 char e2,
                 char e3,
                 char e4)

Adds four chars to the stack.

push

public void push(char[] elements,
                 int start,
                 int len)

Add a range of array elements to the stack.

push

public final void push(char... elements)

Vararg-signature method for pushing elements at the top of the stack.

This method is handy, but costly if used in tight loops (anonymous array passing)

pushAll

public int pushAll(CharContainer container)

Pushes all elements from another container to the top of the stack.

pushAll

public int pushAll(java.lang.Iterable<? extends CharCursor> iterable)

Pushes all elements from another iterable to the top of the stack.

discard

public void discard(int count)

Discard an arbitrary number of elements from the top of the stack.

discard

public void discard()

Discard the top element from the stack.

pop

public char pop()

Remove the top element from the stack and return it.

peek

public char peek()

Peek at the top element on the stack.

from

public static CharStack from(char... elements)

Create a stack by pushing a variable number of arguments to it.

clone

public CharStack clone()

Clone this object. The returned clone will reuse the same hash function and array resizing strategy.

Overrides:

clone in class CharArrayList