Utility Functions and C Language Reference > Utility Functions: Java (lr.) > Alphabetical Listing > lr_eval_string

lr_eval_string

Returns the string argument after evaluating embedded parameters.

C Language

char *lr_eval_string( char *instring  );
Example: lr_eval_string String and Parameter Functions

Java Language

String lr.eval_string( String instring );
Example: lr.eval_string String and Parameter Functions Java Syntax

Arguments

Name Comments
instring The string to evaluate.

The lr_eval_string function returns the input string after evaluating any embedded parameters. If the string argument contains only a parameter, the function returns the current value of the parameter.

Embedded parameters must be in brackets.

Note: lr_eval_string allocates memory internally. The memory is automatically freed at the end of each iteration. You can use lr_eval_string_ext and manually free the memory in each iteration with lr_eval_string_ext_free. Do not, however, use a free statement in your custom code, as this may result in memory corruption.

Return Values

This function returns the value of the specified string or null on error.

Parameterization

All arguments can be parameterized using standard parameterization.