ICAM Virtual Machine V19 - Kxcad.net

The $FBASNAM Function
result=$FBASNAM(s1[,s2])
Returns: String
Virtual Machine Reference, Model Customization
Simulation Macro Functions, File and Directory Functions
This function extracts and returns the file name portion of a file path string s1, optionally removing
any trailing portion s2 of the file name that matched the suffix string. The syntax is as
follows:
file_name_string=$FBASNAM(path_string [,suffix_string])
For example, “test.cld” is the base portion of “C:\temp\test.cld”. When removing a trailing
suffix, the $FBASNAM function looks for the last occurrence of the suffix in the file name, and
then removes the remainder of the file name from the matched point onwards. Case is significant.
Continuing the example, “test” would be returned if “.” (a decimal) is specified as a suffix.
The $FCTIME Function
result=$FCTIME(n)
Returns: String
This function returns the date and time in string format, given a real number n specifying the
number of seconds since the operating system specific “epoch” time. This function can be used
to convert time values from the $FSTAT function to a human readable format. The syntax is as
follows:
date_string=$FCTIME(real)
The date string is output in the following format with a single blank between the date and time
portions:
dd-mm-yyyy hh:mm:ss
The $FDIRNAM Function
result=$FDIRNAM(s)
Returns: String
This function extracts and returns the directory name portion of a file path string a. The path
string need not contain directory name information. The syntax is as follows:
path_string=$FDIRNAM(path_string)
ICAM Technologies Corporation – Proprietary 177