sp_GetCollations

Advantage SQL Engine

Retrieve the list of collations that can be loaded dynamically.

Syntax

sp_GetCollations( Pattern,CICHARACTER,100 )

Parameters

Pattern (I)

Name pattern that can be used to restrict the result set. For example, if the parameter is ‘general%’, all of the collations beginning with the word ‘general’ would be returned. If an empty string or NULL is given, all collations are returned.

Output

The sp_GetCollations procedure will return a result set containing information about available dynamic collations.

Field Name

Field Type

Field Size

Description

Name

CiCharacter

100

The collation name.

ShortName

CiCharacter

8

The short collation name. This is the name that is used directly in Visual FoxPro.

Description

Memo

9

A text description of the collation.

Version

Integer

4

The version number of the collation table.

CodePage

Integer

4

The code page with which the collation table is associated.

FoxCompat

Logical

1

Flag indicating if the collation is a Visual FoxPro compatible collation.

AllowMultiple

Logical

1

Flag that indicates whether the collation table can be used at the same time as other collation tables on a given DBF or ADT table.

 

Remarks

sp_GetCollations retrieves the list of collations that are currently available for dynamic loading by Advantage Database Server or Advantage Local Server. The collations that are returned are the ones currently in the adscollate.adt table. Normally, applications would not need to use this procedure unless it was desired to present a list of collations to the user to choose from.

Example

The following example will retrieve all available collation tables:

EXECUTE PROCEDURE sp_GetCollations( NULL );

The next example will retrieve all available Spanish collations:

EXECUTE PROCEDURE sp_GetCollations( ‘Spanish%’ );

 

See Also

sp_GetCollationTable

Dynamic Collation Support