StrConvert

transform a string according to collation information. (V38)

This function transforms the passed string and places the resulting into the supplied buffer. No more than bufferSize bytes are copied into the buffer.

The transformation is such that if the C strcmp() function is applied to two transformed strings, it returns a value corresponding to the result returned by the StrnCmp() function applied to the two original strings.

locale

the locale to use for the transformation

string

NULL-terminated string to transform

buffer

buffer where to put the transformed string

bufferSize

maximum number of bytes to deposit in the buffer StrConvert() may require more storage than the unconverted string does

type

describes how the transformation is to be performed. See the documentation on StrnCmp() for more information on the comparison types available. Note that SC_COLLATE2 does append all characters from the original string which differ from the transformed character to the transformed string, e.g. "teSt" -> "TESTtet" which is probably not what you want.

length

length of the transformed string which is the number of bytes deposited in the buffer minus 1 (since strings are NULL- terminated)

Prior to V46, the builtin default routine (it can be replaced by the default language driver or, since V46, by the default charset driver) had bugs in the Collate table used for SC_COLLATE1 and SC_COLLATE2 transformations (See the StrnCmp description for details). And it did not restore the stack pointer if an unknown type was specified. Fixed in V46.

StrnCmp(), <libraries/locale.h>