ICAM Virtual Machine V19 - Kxcad.net

ICAM Virtual Machine ® Virtual Machine Reference, Model Customization
Simulation Macro Functions, Other Functions
or -1 if the sort failed. The $ERRNO system variable will be set to a non-zero value if the sort
failed.
result=$FSORT(sequence [,fields [,field,order [,…]] ])
Returns: Sequence
When sorting a sequence, the input sequence is specified as the first parameter of the $FSORT
function and the sorted result is returned as a sequence. If all elements of the sequence are the
same type (e.g., all numbers or all strings), then $FSORT can be called with just the input
sequence to sort the elements in increasing order. If the sequence represents a table (e.g., alternating
pairs of number and string elements), then the fields parameter must be specified to tell
the sort function the number of fields (or columns) that make up each record (or row) to be
sorted in the sequence. The default increasing order of sorting can be changed by specifying a
“field,order” sort key parameter, where field identifies a field number and order is one of the
keywords INCR or DECR. Additional sort keys can be specified to sort records with identical
sort key fields. If all sort keys are the same, then the original record order is maintained. If the
sort fails, a null sequence (i.e., $NULL) will be returned and the $ERRNO system variable will
be set to a non-zero value.
204 ICAM Technologies Corporation – Proprietary