String left and string right, B.3.3 string left and string right – Nematron Pointe Controller User Manual

Page 310

Advertising
background image

Appendix B: Flow Chart Command Reference

Pointe Controller User Guide

308

B.3.3 String Left and String Right

These commands can be selected from the

String commands

list.

When used in a Flow Chart, the String Left and String Right commands extract a
sub-string of a specified length from a given string. The String Left command
extracts from the left side of the string. The String Right command extracts from
the right side of the string.

Parameters for these commands include:

Destination String – The String tag to which the extracted sub-string
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 from which the sub-string will be extracted.

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.

Number Chars – The length of the sub-string, in characters, to be

extracted.

The value of Number Chars may be an Input/Memory/Output tag, a literal
numeric value, or some other logical expression that is evaluated every
time the block is executed.

To configure the Number Chars parameter, click the

button to open a

standard

Build Argument

dialog.

Advertising