NEWIDSTRING()

Advantage Concepts

Advantage Expression Engine function that returns a GUID.

Syntax

NEWIDSTRING (<format> ) -> cGUIDString

Parameters

<format>

A string specifying the format for the returned GUID.

M or MIME

A GUID encoded as a 24-byte string using MIME base64 encoding with the format of xxxxxxxxxxxxxxxxxxxxxxxx. Base64 encoded strings are case sensitive and should not be stored in case insensitive string fields.

F or File

A GUID encoded as a 22-byte string using File and URL Safe base64 encoding with the format of xxxxxxxxxxxxxxxxxxxxxx. Base64 encoded strings are case sensitive and should not be stored in case insensitive string fields.

N or Numbers

A GUID encoded as a 32-byte hexadecimal string value with a format of xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

D or Delimited

A GUID encoded as a 32-byte hexadecimal string with a format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

B or Bracketed

A GUID encoded as a 32-byte hexadecimal string with a format of {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

P or Parenthesis

A GUID encoded as a 32-byte hexadecimal string with a format of (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Return Value

NEWIDSTRING returns a string formatted GUID.

Remarks

NEWIDSTRING() returns a Globally Unique Identifier (GUID) formatted as string. GUIDs are spatially and temporally unique values.

Note This function is currently only supported on Microsoft Windows operating systems.

Note Advantage Expression Engine functions can be used in expressions such as record filter expressions and index expressions. They are not necessarily scalars supported within SQL statements. For a list of supported SQL scalar functions, see Supported Scalar Functions.

Examples

NEWIDSTRING( "NUMBERS" )