|
|
|
|
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.