au.com.codeka.carrot

Class Scope

java.lang.Object

au.com.codeka.carrot.Scope

public class Scope
extends java.lang.Object

Scope is a collection of all the bindings that are active. The scope is basically a stack: each time you iterate down a node, you can push new bindings onto the stack and those will be the first one searched for a variable.

Constructor Summary

Constructors

Constructor and Description
Scope(Bindings globalBindings) Create a new Scope, with the given initial set of "global" bindings.

Method Summary

Modifier and Type	Method and Description
void	extendCurrent(Bindings bindings) Extend the current bindings with the given one.
void	pop() Pop the most recent bindings off the stack.
void	push(Bindings bindings) Push the given bindings onto the stack.
java.lang.Object	resolve(java.lang.String name) Resolve the given named variable from the stack of bindings, most recently-pushed to last.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Scope

public Scope(Bindings globalBindings)

Create a new Scope, with the given initial set of "global" bindings.

Parameters:

globalBindings - A set of "global" bindings that you want first on the stack.

Method Detail

push

public void push(Bindings bindings)

Push the given bindings onto the stack.

Parameters:

bindings - The bindings to push.

pop

public void pop()

Pop the most recent bindings off the stack.

extendCurrent

public void extendCurrent(Bindings bindings)

Extend the current bindings with the given one.

Parameters:

bindings - The new Bindings.

resolve

@Nullable
public java.lang.Object resolve(@Nonnull
                                          java.lang.String name)

Resolve the given named variable from the stack of bindings, most recently-pushed to last.

Parameters:

name - The name to resolve.

Returns:

The resolved value, or null if the value doesn't exist in this scope.