version 2003
PA_Detokenize (tokens; len; text) long
Parameter | Type | Description | |
tokens | char * | Tokens to be detokenized | |
len | long | Length of the tokens buffer | |
text | char * | Detokenized formula, or 0 to read the text size | |
Function result | long | Length of the detokenized text |
Description
The routine PA_Detokenize allows the 4D Plug-in to retrieve the text of the 4D statement or expression corresponding to the tokenized 4D formula that has been passed.
Before the call, pass the tokenized 4D statement or expression in tokens (which the 4D Plug-in obtains using the PA_Tokenize) and its length in len.
After the call, the routine returns the length of the detokenized text, and the text itself in text. You can pass a null pointer to receive the length of the buffer to allocate and then call the function again with the allocated buffer.
Unlike PA_DetokenizeInTEHandle which is MacOS or Windows+Mac2Win specific, PA_Detokenize allows the developer to manipulate the detokenized text regardless of the platform.
PA_Detokenize benefits
See PA_DetokenizeInTEHandle for an example of use.
See Also
PA_DetokenizeInTEHandle, PA_Tokenize.
Error Handling
Use PA_GetLastError to see if an error occurred