Module coneforest.psylla

Package coneforest.psylla.runtime

Class DictStack

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<E>

coneforest.psylla.runtime.Stack<PsyFormalDict<PsyObject>>

coneforest.psylla.runtime.DictStack

All Implemented Interfaces:

Serializable, Cloneable, Iterable<PsyFormalDict<PsyObject>>, Collection<PsyFormalDict<PsyObject>>, List<PsyFormalDict<PsyObject>>, RandomAccess

public class DictStack
extends Stack<PsyFormalDict<PsyObject>>

An interpreter’s dictionary stack.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
DictStack()	Creates a new dictionary stack with two permanent dictionaries in it (system and user dictionaries).

Method Summary

Modifier and Type	Method	Description
void	begin(PsyFormalDict oDict)	Pushes the dictionary to this stack.
Object	clone()
PsyNamespace	currentNamespace()
void	end()	Pops a non-permanent dictionary from this stack.
<T extends PsyObject> T	load(PsyTextual oKey)	Performs in-depth search for the given textual key in this stack and returns the associated value.
<T extends PsyObject> T	load(String key)	Performs in-depth search for the given key in this stack and returns the associated value.
void	store(PsyTextual oKey, PsyObject oValue)
Optional<PsyFormalDict>	where(PsyTextual oKey)	Performs in-depth search for the dictionary containing the given textual key in this stack and returns an Optional contating the dictionary found or empty Optional if not found.
Optional<PsyFormalDict>	where(String key)	Performs in-depth search for the dictionary containing the given key in this stack and returns an Optional contating the dictionary found or empty Optional if not found.

Methods inherited from class coneforest.psylla.runtime.Stack

peek, pop, push, setSize

Methods inherited from class java.util.ArrayList

add, add, addAll, addAll, clear, contains, ensureCapacity, equals, forEach, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractCollection

containsAll, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, stream, toArray

Methods inherited from interface java.util.List

containsAll

Constructor Details

DictStack

public DictStack()
          throws PsyUndefinedException

Creates a new dictionary stack with two permanent dictionaries in it (system and user dictionaries).

Throws:

PsyUndefinedException - when TODO.

Method Details

clone

public Object clone()

Overrides:

clone in class ArrayList<PsyFormalDict<PsyObject>>

load

public <T extends PsyObject> T load(String key)
                             throws PsyUndefinedException

Performs in-depth search for the given key in this stack and returns the associated value.

Type Parameters:

T - the type of the value.

Parameters:

key - the key.

Returns:

the associated value.

Throws:

PsyUndefinedException - if the key is not found.

load

public <T extends PsyObject> T load(PsyTextual oKey)
                             throws PsyUndefinedException

Performs in-depth search for the given textual key in this stack and returns the associated value.

Type Parameters:

T - the type of the value.

Parameters:

oKey - the textual key.

Returns:

the associated value.

Throws:

PsyUndefinedException - if the key is not found.

where

public Optional<PsyFormalDict> where(String key)

Performs in-depth search for the dictionary containing the given key in this stack and returns an Optional contating the dictionary found or empty Optional if not found.

Parameters:

key - the key.

Returns:

a Optional containing the dictionary found.

where

public Optional<PsyFormalDict> where(PsyTextual oKey)

Performs in-depth search for the dictionary containing the given textual key in this stack and returns an Optional contating the dictionary found or empty Optional if not found.

Parameters:

oKey - the textual key.

Returns:

an Optional containing the dictionary found.

currentNamespace

public PsyNamespace currentNamespace()

store

public void store(PsyTextual oKey,
 PsyObject oValue)

begin

public void begin(PsyFormalDict oDict)

Pushes the dictionary to this stack.

Parameters:

oDict - the formaldict dictionary.

end

public void end()
         throws PsyDictStackUnderflowException

Pops a non-permanent dictionary from this stack.

Throws:

PsyDictStackUnderflowException - if this stack does not contain non-permanent dictionaries.