ICAM Virtual Machine V19 - Kxcad.net

ICAM Virtual Machine ® Virtual Machine Reference, Model Customization
Simulation Macro Functions, Character and Sequence Functions
The $FICHAR Function
result=$FICHAR(s)
Returns: Numeric
This function returns the ASCII numeric representation of the character s. Only the first character
of s is used by this function.
The $FINDEX Function
result=$FINDEX(s1,s2)
Returns: Numeric
This function returns the starting position of the string s2 within the string s1. If s2 is not contained
in s1, the function will return 0.
The $FLEN Function
result=$FLEN(a)
Returns: Numeric
This function returns the length of the input string or sequence a. Note that the length may be
zero if a is an empty string ('') or an empty sequence.
The $FMATCH Function
result=$FMATCH(s1,s2[,s3][,n])
Returns: String
This function searches for an occurrence of the search string s2 in string s1. If found, the
matched portion of string s1 is returned, or if string s3 is specified, string s3 will be returned. The
default action is to locate the first matching occurrence of s2 in s1. This can be changed by
specifying n. If n is one (1), only the first match is returned (the default). Larger values of n
cause the specified match number to be returned. If a match is not found, $FMATCH returns an
empty string.
The search string s2 can contain special characters in the form of a regular expression (RE)
commonly found in UNIX search functions. See the $FEDIT function for a description of RE‟s.
The substitution string s3 in the $FMATCH function can reference matched text saved in numbered
buffers using the \( and \) sequence. For example,
%L01=$FMATCH($P1,'N\([0-9][0-9]*\)','\1').
This returns only the numeric portion of the matched text. If the third argument was omitted, the
entire matched text would be returned.
172 ICAM Technologies Corporation – Proprietary