Lookup functions




uChoice

Description

Returns the Nth parameter value specified by index. The index value is zero-based, so an index of zero returns the second parameter

Syntax

string uChoice(index, values, ...)

Parameters

integer index

The index number referencing the return value. Zero based.

string values

List of values.

Examples

Example 1

IF construct:

uChoice(0, "A", "B")  // returns "A" 
uChoice(1, “A”, “B”) // returns “B”

Example 2

CASE constructs:

uChoice(2, "n.a.", "Jan", "Feb", "Mar") //returns "Feb"

Example 3

Simulate a lookup function where you want to replace a color ID with a corresponding color name:

uChoice(IN.Color, “n.a.”, “Red”, “Blue”, “Green”)



uFirstDifferent

Description

Returns the first parameter value that is different from the first parameter.

Syntax

string uFirstDifferent(params, ... )

Parameters

params

A list of expressions or values of any data type.

Examples

Example 1

To find the first different attribute in a list:

uFirstDifferent("2004-05-01", "2004-05-01", "2005-01-04", "2005-11-24",) //returns "2005-01-04"



uFirstNotNull

Description

Returns the first non-null value in the list.

Syntax

string uFirstNotNull(params, ...)

Parameters

params

A list of expressions or values of any data type.

Examples

Example 1

To merge four distinct attribute values:

uFirstNotNull(null, null , "A", "B")  // returns "A"



uElements

Description

Returns the number of elements in a delimited string. If the second parameter is omitted, a space (ASCII 32) will be taken as a delimiter.

Syntax

string uElements(text [, delimiter])

Parameters

string text

A string to investigate.

string delimiter(optional)

The delimiter to be used. The default delimiter is a space character.

Examples

Example 1

To count tokens in a delimited string:

uElements("James T. Kirk")  // returns 3



uToken

Description

Returns the Nth element from a delimited string. The second parameter specifies the token number. The index starts at 1. If the third parameter is omitted, a space (ASCII 32) is taken as the delimiter.

Syntax

string uToken(text, index [, delimiter])

Parameters

string text

A string to investigate.

integer index

Number of tokens to be returned.

string delimiter (optional)

The delimiter to be used. The default delimiter is a space character.

Examples

Example 1

To split a delimited string:

uToken("James T. Kirk", 1)  // returns "James"
uToken("James T. Kirk", 2)  // returns "T."