C API Reference -- Ns_TclEnterSet

### Ns_TclEnterSet

#### Overview

Make an Ns_Set accessible through Tcl

#### Syntax

        int Ns_TclEnterSet(
        Tcl_Interp *interp,
        Ns_Set *set,
        int flags
        );

#### Description

Ns_TclEnterSet makes an Ns_Set accessible through Tcl. The new set ID is sprintf'ed directly into interp->result. It returns either NS_OK or NS_ERROR. The flags can be one or more of the following:

NS_TCL_SET_TEMPORARY: | The set is temporary and private to the Tcl interpreter. The set ID will be automatically deleted by Ns_TclDeAllocateInterp().
NS_TCL_SET_PERSISTENT: | The set can be accessed by any Tcl interpreter in the server and the set ID will persist beyond the interpreter's next call to Ns_TclDeAllocateInterp().
NS_TCL_SET_DYNAMIC: | The set was dynamically allocated for use by Tcl and will be garbage-collected when the cooresponding set ID is deleted through either Ns_TclFreeSet() or Ns_TclDeAllocateInterp().

Sets created by Tcl are normally DYNAMIC and TEMPORARY unless the -persist option is used in the Tcl function when creating the set.

#### Examples

        set = Ns_SetCreate(name);
        return Ns_TclEnterSet(interp, set,
        	NS_TCL_SET_TEMPORARY | NS_TCL_SET_DYNAMIC);

Top of Page
Copyright © 1998-99 America Online, Inc.