version 2003
PA_ExecuteTokensAsFunction (tokens; len) PA_Variable
Parameter | Type | Description | |
tokens | char * | Tokens to execute | |
len | long | Length of the tokens' buffer | |
Function result | PA_Variable | Function result |
Description
The routine PA_ExecuteTokensAsFunction allows the 4D Extension to evaluate any pre-tokenized 4D statement that returns a result, in other words, a pre-tokenized 4th Dimension expression. For pre-tokenized statements that do not return a result, use PA_ExecuteTokens.
Pass a pointer to the buffer that holds the tokens in tokens and its length in len before the call.
Once 4th Dimension has evaluated and executed the expression, it returns the result in a structure of type PA_Variable. This API gives the developer accessors to PA_Variables.
IMPORTANT NOTE:
After the call, it is the 4D Plug-in's responsibility to dispose of the result if its type is Text, Picture or BLOB. Use PA_ClearVariable for this purpose.
The types of uses for PA_ExecuteTokensAsFunction, as well as re-entrance precaustions, are identical to those of PA_ExecuteFunction. For more information, refer to the entry point PA_ExecuteFunction.
See Also
PA_ExecuteFunction, PA_ExecuteTokens, PA_Tokenize.
Error Handling
Use PA_GetLastError to see if an error occurred.