str

Purpose

Converts an integer or numerical value or a text value to a string data type.

Syntax

str(value[,raw:=yes/no])

Arguments

Requires a single argument of an integer, numerical, string, or text data type.

The function also accepts the second optional argument raw. When raw:=yes, the str() function ignores column regional settings and uses default settings.

Returned Value

The input value in its string format.

If the input value is null, a null string value is returned.

If converting from a text value to a string value, note that PolyAnalyst only allows a maximum number of characters to be stored in a string value and will truncate the text value to the maximum number of characters if necessary.

Examples

Expression

Returned Value

str(1)

"1"

str(1.2)

"1.2"