All Implemented Interfaces:

Named

Direct Known Subclasses:

BuiltinEnvironment, SimpleEnvironment

public abstract class Environment
extends PropertySet 

• Field Summary

  Fields

  Modifier and Type	Field and Description
  protected static gnu.mapping.Environment.InheritedLocal	curEnvironment
  static int	INDIRECT_DEFINES Newly defined locations are created in inherited parent environment.

  • Fields inherited from class gnu.mapping.PropertySet

    nameKey

• Constructor Summary

  Constructors

  Constructor and Description
  Environment ()

• Method Summary

  All Methods

  Modifier and Type	Method and Description
  void	addLocation (EnvironmentKey key, Location loc)
  void	addLocation (NamedLocation loc)
  abstract NamedLocation	addLocation (Symbol name, java.lang.Object prop, Location loc)
  boolean	containsKey (java.lang.Object key)
  static Environment	current () Deprecated.
  Namespace	defaultNamespace ()
  abstract void	define (Symbol key, java.lang.Object property, java.lang.Object newValue)
  abstract LocationEnumeration	enumerateAllLocations () Does enumerate inherited Locations.
  abstract LocationEnumeration	enumerateLocations () Does not enumerate inherited Locations.
  java.lang.Object	get (EnvironmentKey key, java.lang.Object defaultValue)
  java.lang.Object	get (java.lang.Object key) Get the value bound to the given name.
  java.lang.Object	get (java.lang.String key, java.lang.Object defaultValue)
  java.lang.Object	get (Symbol sym)
  java.lang.Object	get (Symbol key, java.lang.Object property, java.lang.Object defaultValue)
  boolean	getCanDefine () True if new bindings (non-unbound Locations) can be added.
  boolean	getCanRedefine () True if bindings can be removed or replaced by other kinds of Location.
  java.lang.Object	getChecked (java.lang.String name) Get the value bound to the given name.
  static Environment	getCurrent ()
  int	getFlags ()
  java.lang.Object	getFunction (Symbol sym)
  java.lang.Object	getFunction (Symbol key, java.lang.Object defaultValue)
  static Environment	getGlobal ()
  static Environment	getInstance (java.lang.String name)
  Location	getLocation (java.lang.Object key, boolean create)
  Location	getLocation (Symbol key) Return a location bound to key (and null property).
  Location	getLocation (Symbol key, java.lang.Object property) Return a location bound to (key, property).
  NamedLocation	getLocation (Symbol name, java.lang.Object property, boolean create)
  abstract NamedLocation	getLocation (Symbol key, java.lang.Object property, int hash, boolean create)
  Symbol	getSymbol (java.lang.String name)
  protected abstract boolean	hasMoreElements (LocationEnumeration it)
  boolean	isBound (Symbol key)
  boolean	isBound (Symbol key, java.lang.Object property)
  boolean	isLocked () True if this environment is locked - bindings cannot be added or removed.
  Location	lookup (Symbol key)
  Location	lookup (Symbol key, java.lang.Object property) Return a location bound to (key, property).
  abstract NamedLocation	lookup (Symbol name, java.lang.Object property, int hash)
  static SimpleEnvironment	make ()
  static SimpleEnvironment	make (java.lang.String name)
  static InheritingEnvironment	make (java.lang.String name, Environment parent)
  java.lang.Object	put (java.lang.Object key, java.lang.Object newValue)
  java.lang.Object	put (java.lang.String key, java.lang.Object value)
  void	put (Symbol key, java.lang.Object newValue)
  void	put (Symbol key, java.lang.Object property, java.lang.Object newValue)
  void	putFunction (Symbol key, java.lang.Object newValue)
  java.lang.Object	remove (EnvironmentKey key) Remove and undefine binding.
  java.lang.Object	remove (java.lang.Object key)
  void	remove (Symbol sym)
  java.lang.Object	remove (Symbol symbol, java.lang.Object property)
  java.lang.Object	remove (Symbol key, java.lang.Object property, int hash) Remove Location from this Environment and undefine it.
  void	removeFunction (Symbol sym)
  static void	restoreCurrent (Environment saved)
  void	setCanDefine (boolean canDefine)
  void	setCanRedefine (boolean canRedefine)
  static void	setCurrent (Environment env)
  void	setFlag (boolean setting, int flag)
  static void	setGlobal (Environment env)
  void	setIndirectDefines ()
  void	setLocked ()
  static Environment	setSaveCurrent (Environment env)
  java.lang.String	toString ()
  java.lang.String	toStringVerbose () Overridden in sub-classes - useful for more verbose debug output.
  Location	unlink (Symbol key, java.lang.Object property, int hash) Remove Location from this Environment.
  static Environment	user ()

  • Methods inherited from class gnu.mapping.PropertySet

    getName, getProperty, getSymbol, removeProperty, setName, setProperty, setProperty, setSymbol

  • Methods inherited from class java.lang.Object

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

• Field Detail

  • INDIRECT_DEFINES

    public static final int INDIRECT_DEFINES

    Newly defined locations are created in inherited parent environment.

    See Also:

    Constant Field Values

  • curEnvironment

    protected static final gnu.mapping.Environment.InheritedLocal curEnvironment

• Constructor Detail

  • Environment

    public Environment()

• Method Detail

  • setGlobal

    public static void setGlobal(Environment env)

  • getGlobal

    public static Environment getGlobal()

  • getFlags

    public int getFlags()

  • setFlag

    public void setFlag(boolean setting,
     int flag)

  • getCanDefine

    public boolean getCanDefine()

    True if new bindings (non-unbound Locations) can be added.

  • setCanDefine

    public void setCanDefine(boolean canDefine)

  • getCanRedefine

    public boolean getCanRedefine()

    True if bindings can be removed or replaced by other kinds of Location.

  • setCanRedefine

    public void setCanRedefine(boolean canRedefine)

  • isLocked

    public final boolean isLocked()

    True if this environment is locked - bindings cannot be added or removed.

  • setLocked

    public void setLocked()

  • setIndirectDefines

    public final void setIndirectDefines()

  • getLocation

    public final Location getLocation(Symbol key,
     java.lang.Object property)

    Return a location bound to (key, property). Create new unbound Location if no such Location exists.

  • getLocation

    public final Location getLocation(Symbol key)

    Return a location bound to key (and null property). Create new unbound Location if no such Location exists.

  • lookup

    public final Location lookup(Symbol key,
     java.lang.Object property)

    Return a location bound to (key, property). Return null if no such Location exists.

  • lookup

    public abstract NamedLocation lookup(Symbol name,
     java.lang.Object property,
     int hash)

  • lookup

    public final Location lookup(Symbol key)

  • getLocation

    public abstract NamedLocation getLocation(Symbol key,
     java.lang.Object property,
     int hash,
     boolean create)

  • getLocation

    public final NamedLocation getLocation(Symbol name,
     java.lang.Object property,
     boolean create)

  • getLocation

    public final Location getLocation(java.lang.Object key,
     boolean create)

  • isBound

    public boolean isBound(Symbol key,
     java.lang.Object property)

  • isBound

    public final boolean isBound(Symbol key)

  • containsKey

    public final boolean containsKey(java.lang.Object key)

  • getChecked

    public final java.lang.Object getChecked(java.lang.String name)

    Get the value bound to the given name.

    Throws:

    UnboundLocationException - the name has no binding

    See Also:

    get(Object)

  • get

    public java.lang.Object get(Symbol key,
     java.lang.Object property,
     java.lang.Object defaultValue)

  • get

    public final java.lang.Object get(EnvironmentKey key,
     java.lang.Object defaultValue)

  • get

    public final java.lang.Object get(java.lang.String key,
     java.lang.Object defaultValue)

  • get

    public java.lang.Object get(Symbol sym)

  • getFunction

    public final java.lang.Object getFunction(Symbol key,
     java.lang.Object defaultValue)

  • getFunction

    public final java.lang.Object getFunction(Symbol sym)

  • get

    public final java.lang.Object get(java.lang.Object key)

    Get the value bound to the given name. Returns null if the name has no binding (for compatibility with Java2 Collections framework).

    See Also:

    getChecked(String)

  • put

    public void put(Symbol key,
     java.lang.Object property,
     java.lang.Object newValue)

  • define

    public abstract void define(Symbol key,
     java.lang.Object property,
     java.lang.Object newValue)

  • put

    public final void put(Symbol key,
     java.lang.Object newValue)

  • put

    public final java.lang.Object put(java.lang.Object key,
     java.lang.Object newValue)

  • putFunction

    public final void putFunction(Symbol key,
     java.lang.Object newValue)

  • put

    public final java.lang.Object put(java.lang.String key,
     java.lang.Object value)

  • unlink

    public Location unlink(Symbol key,
     java.lang.Object property,
     int hash)

    Remove Location from this Environment. Does not explicitly undefine the location itself.

  • remove

    public java.lang.Object remove(Symbol key,
     java.lang.Object property,
     int hash)

    Remove Location from this Environment and undefine it.

  • remove

    public final java.lang.Object remove(EnvironmentKey key)

    Remove and undefine binding.

    Returns:

    Old value

  • remove

    public final java.lang.Object remove(Symbol symbol,
     java.lang.Object property)

  • remove

    public final void remove(Symbol sym)

  • removeFunction

    public final void removeFunction(Symbol sym)

  • remove

    public final java.lang.Object remove(java.lang.Object key)

  • defaultNamespace

    public Namespace defaultNamespace()

  • getSymbol

    public Symbol getSymbol(java.lang.String name)

  • getInstance

    public static Environment getInstance(java.lang.String name)

  • enumerateLocations

    public abstract LocationEnumeration enumerateLocations()

    Does not enumerate inherited Locations.

  • enumerateAllLocations

    public abstract LocationEnumeration enumerateAllLocations()

    Does enumerate inherited Locations.

  • hasMoreElements

    protected abstract boolean hasMoreElements(LocationEnumeration it)

  • current

    @Deprecated
    public static Environment current()

    Deprecated.

  • getCurrent

    public static Environment getCurrent()

  • setCurrent

    public static void setCurrent(Environment env)

  • setSaveCurrent

    public static Environment setSaveCurrent(Environment env)

  • restoreCurrent

    public static void restoreCurrent(Environment saved)

  • user

    public static Environment user()

  • addLocation

    public final void addLocation(NamedLocation loc)

  • addLocation

    public abstract NamedLocation addLocation(Symbol name,
     java.lang.Object prop,
     Location loc)

  • addLocation

    public final void addLocation(EnvironmentKey key,
     Location loc)

  • make

    public static SimpleEnvironment make()

  • make

    public static SimpleEnvironment make(java.lang.String name)

  • make

    public static InheritingEnvironment make(java.lang.String name,
     Environment parent)

  • toString

    public java.lang.String toString()

    Overrides:

    toString in class java.lang.Object

  • toStringVerbose

    public java.lang.String toStringVerbose()

    Overridden in sub-classes - useful for more verbose debug output.