# RESTTOKEN()

Restore global token environment

Syntax

  RESTTOKEN (<cStaticTokenEnvironment>) -> cOldStaticEnvironment

Arguments

  <cStaticTokenEnvironment> a binary string encoding a TE

Returns

  <cOldStaticEnvironment> a string encoding the old global TE

Description

  The RESTTOKEN() function restores the global TE to the one encoded in <cStaticTokenEnvironment>. This can either be the return value of SAVETOKEN() or the value stored in the 4th parameter in a TOKENINIT() call.

Status

  Ready

Compliance

  RESTTOKEN() is compatible with CTIII's RESTTOKEN(),

Platforms

  All

Files

  Source is token2.c, library is libct.

See Also

- TOKENINIT()
- TOKENEXIT()
- TOKENNEXT()
- TOKENNUM()
- TOKENAT()
- SAVETOKEN()
- TOKENEND()