Description: This function adds a new statement to an existing state and returns its own error code.
Warning: This function may cause irrecoverable alteration of your application. It should be used only by advanced programmers.
Returns: Error code (0 = success, non-zero = failure)
Usage: Script
Format: AddStatement(Statement, Destination, TextSize)
Parameters: Statement { Statement } { required } { no default: }
Statement is any expression that returns a statement value. Commonly generated with the Compile function.
Destination { code value } { required } { no default: }
Destination is any expression that returns a code value. This indicates where to insert the new statement. If no statement is present in the code value, the new statement will be appended.
TextSize { numeric } { required } { no default: }
TextSize is any numeric expression giving the length of the statement text in characters.
Comments: AddStatement doesn't affect the .SRC file; it affects the expected location of items in the .SRC file. Both must be updated in unison.
The return value is 0 if successful and non-zero if the function fails.
AddStatement is disabled in the run time version of VTS; it will do nothing and return invalid.
See Also: