"Fossies" - the Fresh Open Source Software archive

Member "jacl1.4.1/docs/TclJavaLib/setVar.htm" (8 May 1999, 10457 Bytes) of archive /linux/misc/jacl1.4.1.tar.gz:


Caution: In this restricted "Fossies" environment the current HTML page may not be correctly presentated and may have some non-functional links. Alternatively you can here view or download the uninterpreted source code. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.

CLASS
tcl.lang.Interp -- This manual entry contains Interp methods that manipulate Tcl variables.
METHODS
void setVar(String name, TclObject value, int flags) throws TclException
void setVar(String part1, String part2, TclObjectvalue, int flags) throws TclException
TclObject getVar(String name, int flags) throws TclException
TclObject getVar(String part1, String part2, int flags) throws TclException
void unsetVar(String name, int flags) throws TclException
void unsetVar(String part1, String part2, int flags) throws TclException
OTHER METHODS
ARGUMENTS
DESCRIPTION
setVar
getVar
unsetVar
OVERLOADING
FLAGS
TCL.GLOBAL_ONLY
TCL.NAMESPACE_ONLY
TCL.APPEND_VALUE
TCL.LIST_ELEMENT
EQUIVALENT C FUNCTIONS
SEE ALSO
KEYWORDS

CLASS

tcl.lang.Interp -- This manual entry contains Interp methods that manipulate Tcl variables.

METHODS

void setVar(String name, TclObject value, int flags) throws TclException

void setVar(String part1, String part2, TclObjectvalue, int flags) throws TclException

TclObject getVar(String name, int flags) throws TclException

TclObject getVar(String part1, String part2, int flags) throws TclException

void unsetVar(String name, int flags) throws TclException

void unsetVar(String part1, String part2, int flags) throws TclException

OTHER METHODS

createCommand, traceVar, eval, setResult, backgroundError,
getNotifier, setAssocData, dispose, pkgRequire

ARGUMENTS

String name ()
Name of variable. May refer to a scalar variable or an array variable with a parenthesized index.

String part1 ()
Name of scalar or array variable. If part2 is null, part1 is treated like name. Otherwise, part1 must be an array variable with no index.

String part2 ()
If not null, gives name of element within array; in this case part1 must refer to an array variable with no index.

TclObject value ()
The TclObject containing the new value for the variable.

int flags ()
OR-ed combination of bits providing additional information. See below for valid values.

DESCRIPTION

These methods are used to create, modify, read, and delete Tcl variables from Java code.

setVar
The setVar methods create a new variable or modify the existing variable whose name is name or the combination of part1 and part2. See the OVERLOADING section below to learn how arguments part1 and part2 are combined to form a valid variable name. These methods set the given variable to the value given by value and return void. If an error occurs in setting the variable (e.g. an array variable is referenced without giving an index into the array) a TclException is generated and an error message is left in interp's result unless the TCL.DONT_THROW_EXCEPTION flag bit is set.

getVar
The getVar methods return the current value of the variable whose name is name or the combination of part1 and part2 (as described for the setVar method above). The return value is a TclObject containing the variable's value. If an error occurs while reading the variable (e.g. the variable doesn't exist or an array element is specified for a scalar variable), then a TclException is generated and an error message is left in interp's result unless the TCL.DONT_THROW_EXCEPTION flag bit is set.

unsetVar
The unsetVar methods may be used to remove a variable, so that future attempts to read the variable will generate exceptions. The arguments to these methods are treated in the same way as the arguments to the methods above. If the variable cannot be removed because it doesn't exist then a TclException is generated and an error message is left in interp's result unless the TCL.DONT_THROW_EXCEPTION flag bit is set. If an array element is specified, the given element is removed but the array remains. If an array name is specified without an index, then the entire array is removed.

OVERLOADING

These methods are overloaded to allow three different ways to specify variable names.

[1]
If setVar, getVar, or unsetVar is invoked with the name argument, the variable name is given as a single string, name. If name contains an open parenthesis and ends with a close parenthesis, then the value between the parentheses is treated as an index (which can have any string value) and the characters before the first open parenthesis are treated as the name of an array variable. If name doesn't have parentheses as described above, then the entire string is treated as the name of a scalar variable.

[2]
If the part1 and part2 arguments are provided and part2 is not null, then the variable part1(part2) is specified. The part1 argument contains the array name, and the part2 argument contains the index.

[3]
If the part1 and part2 arguments are provided and part2 is null, then part1 is treated the same as the name argument in step [1].

FLAGS

The flags argument may be used to specify any of several options to the methods. It consists of an OR-ed combination of the following bits.

TCL.GLOBAL_ONLY
Under normal circumstances, the procedures look up variables as follows. If a procedure call is active in Interp, the variable is looked up at the current level of procedure call. Otherwise, the variable is looked up first in the current namespace, then in the global namespace. However, if this bit is set in flags then the variable is looked up only in the global namespace, even if there is an active procedure call. If both TCL.GLOBAL_ONLY and TCL.NAMESPACE_ONLY are given, TCL.GLOBAL_ONLY is ignored.

TCL.NAMESPACE_ONLY
If this bit is set in flags then the variable is looked up only in the current namespace; if a procedure is active, its variables are ignored, and the global namespace is also ignored unless it is the current namespace.

TCL.APPEND_VALUE
If this bit is set then value is appended to variable's the current value instead of replacing it. If the variable is currently undefined, then the bit is ignored. This bit is only used by the setVar methods.

TCL.LIST_ELEMENT
If this bit is set, then value is converted to a valid Tcl list element before setting (or appending to) the variable. A separator space is appended before the new list element unless the list element is going to be the first element in a list or sublist (i.e. the variable's current value is empty, or contains the single character ``{'', or ends in `` }'').

EQUIVALENT C FUNCTIONS

Tcl_SetVar, Tcl_SetVar2, Tcl_GetVar, Tcl_GetVar2, Tcl_UnsetVar, Tcl_UnsetVar2

SEE ALSO

Interp, setResult, traceVar

KEYWORDS

array, get, interpreter, object, scalar, set, unset, variable
Copyright © 1998 by Sun Microsystems, Inc.
Copyright © 1995-1997 Roger E. Critchlow Jr.