COLLATE()

Advantage Concepts

Advantage Expression Engine function used to coerce a string value to a specific column-level collation language.

Syntax

COLLATE( <cString>, <collation_lang> ) -> <cString>

Parameters

<cString>

The character string to coerce.

<collation_lang>

The column-level collation language to coerce to.

Return Values

COLLATE returns the string value <cString> with its coercion type changed to COERCION_EXPLICIT and its collation language changed to <collation_lang).

Remarks

<collation_lang> can be one of the following values, and must be surrounded by single quotes:

ads_default_cs

case sensitive

ads_default_ci

case insensitive

Note Memo, binary, and image fields are not supported in this Advantage Expression Engine function. If memo, binary, or image fields are used with this expression engine function, the Advantage Expression Engine will be unable to evaluate the expression.

Example

collate( csfield, ‘ads_default_ci’ )

See Also

Comparison Operators and Coercion