String replace, B.3.7 string replace – Nematron Pointe Controller User Manual

Page 315

Advertising
background image

Pointe Controller User Guide

Appendix B: Flow Chart Command Reference

313

B.3.7 String Replace

This command can be selected from the

String commands

list.

When used in a Flow Chart, the String Replace command replaces a specified
number of characters in a given string with the contents of another string. The
result is written to a separate String tag. This is different from the String Insert
command above; the specified characters are completely overwritten rather than
simply displaced.

Parameters for this command include:

Destination String – The String tag to which the result of the command
will be written.

To configure the Destination String parameter, click the

button to

open a standard

Select String Tag

dialog.

NOTE: If the defined length of the Destination String is not long enough
to receive the result of the command, then the output will be truncated.
No error will be generated.

Source String – The string in which the specified characters will be

replaced.

The value of Source String may be a String tag, a literal string enclosed in
single quotes (‘ ’), or some other logical expression that is evaluated every
time the block is executed.

To configure the Source String parameter, click the

button to open a

standard

Build String Argument

dialog.

NOTE: Source String is not modified by the execution of this command.

Replacement String – The string which will replace the specified

characters in the Source String.

The value of Replacement String may be a String tag, a literal string
enclosed in single quotes (‘ ’), or some other logical expression that is
evaluated every time the block is executed.

Advertising