Function toImmutableStack

toImmutableStack<TElement>(
source: Iterable<TElement>,
comparator?: EqualityComparator<TElement, TElement>,
): ImmutableStack<TElement>
Materialises source into an immutable stack (LIFO).
Type Parameters
- TElement
  Type of elements within source.
Parameters
- source: Iterable<TElement>
  The source iterable.
- Optionalcomparator: EqualityComparator<TElement, TElement>
  Optional equality comparator used by the resulting stack.
Returns ImmutableStack<TElement>
An immutable stack whose top element corresponds to the last element of source.
Remarks
The entire sequence is enumerated immediately.
Example
```
const numbers = [1, 2, 3];
const immutableStack = toImmutableStack(numbers);
console.log(immutableStack.peek()); // 3
console.log(immutableStack.pop().peek()); // 2
```
- Defined in src/enumerator/functions/toImmutableStack.ts:20