GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  BLT_TREEGETTOKEN (3)

NAME

Blt_TreeGetToken - Grabs a token associated with existing tree data object.

CONTENTS

Synopsis
Arguments
Description
Returns
Example
See Also

SYNOPSIS

#include <bltTree.h>

int Blt_TreeGetToken(interp, name, tokenPtr)

ARGUMENTS


.TP 15 Tcl_Interp*interp(in)
Tcl_Interp*interp Tcl_Interp Interpreter to report results back to.
.TP 15 const char*name(in)
const char*name const char Name of an existing tree data object. Can be qualified by a namespace.
.TP 15 Blt_Tree  *tokenPtr(out)
Blt_Tree  *tokenPtr Blt_Tree Points to location to store the client tree token.

   








\L’|0u-1v’\l’75u+3n_’\L’0u+1v-0u’\l’|0u-1.5n_’



\L’|0u-1v’\L’0u+1v-0u’\l’|0u-1.5n_’





DESCRIPTION

This procedure obtains a token to a C-based tree data object. The arguments are as follows:
interp Interpreter to report results back to. If an error occurs, then interp->result will contain an error message.
name Name of an existing tree data object. It’s an error if a tree name doesn’t already exist. Name can be qualified by a namespace such as fred::myTree. If no namespace qualifier is used, the tree the current namespace is searched, then the global namespace.
tokenPtr Points to the location where the returned token is stored. A tree token is used to work with the tree object.
A token for the tree data object is returned. Tree data objects can be shared. For example, the tree and hiertable commands may be accessing the same tree data object. Each client grabs a token that is associated with the tree. When all tokens are released (see Blt_TreeReleaseToken) the tree data object is automatically destroyed.

RETURNS

A standard Tcl result is returned. If TCL_ERROR is returned, then interp->result will contain an error message. The following errors may occur:
o No tree exists as name. You can use Tcl_TreeExists to determine if a tree exists beforehand.
o Memory can’t be allocated for the token.

EXAMPLE

The following example allocated a token for an existing tree.



Blt_Tree token;

if (Blt_TreeGetToken(interp, "myTree", &token) != TCL_OK) { return TCL_ERROR; } printf("tree is %s\n", Blt_TreeName(token));

SEE ALSO

Tcl_TreeCreate, Tcl_TreeExists, Tcl_TreeReleaseToken
Search for    or go to Top of page |  Section 3 |  Main Index


BLT BLT_TREEGETTOKEN (3) 2.5

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.