UNIQUE()

CA-GSS Statements and Commands › GSS Extended Functions › IO Functions › Number, String, and Variable Functions › System Information Functions › UNIQUE()

UNIQUE()

Use the UNIQUE() function to scan a string for a character that does not appear in the string. This character can be used as a delimiter.

Syntax

The UNIQUE() function has this syntax:

char = UNIQUE(string,[prefer],[EXTEND])

Arguments

The UNIQUE() function takes these arguments.

char	Single character that does not appear in string.
string	String to be examined.
prefer	List of preferred characters. If specified, the left-most unique character is returned. The default is to use an internal preference.
EXTEND	If specified and none of the characters specified in prefer is unique, then the preference list will be extended to all 256 possible characters.

Usage Notes

The internally generated preference string is weighted to non-alphanumeric, printable characters. Once these are exhausted, the remainder of the 256 possible characters are used.
Use of EXTEND simply reexecutes the function with the internally generated preference list.

Return Codes

The UNIQUE() function produces these return codes:

101 - 103 ARG n MISSING OR INVALID

121 NO UNIQUE CHARACTER

Example

/*  Return 3 values on the Stack */
   a = .....   /* arbitrary values assigned */
   b = .....
   c = .....
   d = unique(a||b||c)
   queue d||a||d||b||d||c||d
/*  Retrieve the values from the Stack */
   parse pull 1 d +1 a (d) b (d) c (d)

Tell Technical Publications how we can improve this information