PA_ExecuteTokensAsFunction

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_ExecuteTokensAsFunction (tokens; len) PA_Variable

ParameterTypeDescription
tokenschar *Tokens to execute
lenlongLength of the tokens' buffer
Function resultPA_VariableFunction 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.


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next