Advantage SQL Engine
Retrieve the list of collations that can be loaded dynamically.
sp_GetCollations( Pattern,CICHARACTER,100 )
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. |
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. |
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.
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