String Parsing & Manipulation Functions - Crestron SIMPL+ Reference Manual

Crestron SIMPL+
String Parsing & Manipulation Functions
Language Reference Guide - DOC. 5797G
®
String Parsing and Manipulation Functions Overview
String parsing and manipulation functions are used where the contents of string
variables need to be examined or modified.
ClearBuffer
Name:
ClearBuffer
Syntax:
ClearBuffer(STRING BUFFERNAME);
Description:
Deletes the contents of the specified buffer. If a LEN is done on the buffer after a
CLEARBUFFER, the return value will be 0. This is equilavent to assigning an empty
string to the buffer, e.g., BUFFERNAME="";
Parameters:
BUFFERNAME specifies the name of the string to empty. BUFFER_INPUT,
STRING, and STRING_INPUT sources are legal.
Return Value:
None.
Example:
BUFFER_INPUT IN$[100];
CHANGE IN$
{
IF(RIGHT$(IN$,1) = "Z")
CLEARBUFFER(IN$);
// Code to process IN$ goes here.
}
In this example, if the last character that comes into the BUFFER_INPUT is "Z", the
buffer is cleared.
Version:
SIMPL+ Version 1.00
Software
®
SIMPL+ 219