xHarbour Reference Documentation > Function Reference

SaveToken()

Saves the global environment of the incremental tokenizer.

Syntax

SaveToken() --> cGlobalTokenEnv

Return

The function returns the global environment of the tokenizer as a character string.

Description

SaveToken() is required when nested calls to TokenInit() appear in a program. Before the incremental tokenizer is initialized with a new global environment, the current environment of the tokenizer is saved with SaveToken(). Then, a call to TokenInit() prepares the tokenizer with a new global environment. When the new string is processed, the previous global tokenizer environment is restored via RestToken() and the tokenizer can resume processing the previous string.

Info

See also:	RestToken(), TokenInit(), TokenNext()
Category:	CT:String manipulation , Character functions , Token functions
Source:	ct\token2.c
LIB:	xhb.lib
DLL:	xhbdll.dll