Older Newer
Tue, 28 Dec 2021 08:54:40 . . . . SyneRyder [Initial function definition]


Changes by last author:

Added:
= stricoll =

Microsoft-specific C function - not part of ANSI C

== Syntax ==

:int stricoll(const char* s1, const char* s2)

== Arguments ==

:s1

::Pointer to the string to compare.

:s2

::Pointer to the string to which the first string is compared to.

== Return ==

:An integer value indicating the result of the comparison.

== Description ==

:Compares two strings, based on the rules of the current system locale, in a case-insensitive manner.

:If zero is returned, both strings are identical. If a negative value is returned, string s1 is found to be less then s2. If a value positive and greater then zero is returned, string s1 is greater than s2.

:Characters are compared by their locale collation order - that is, the dictionary order for the locale. So while in extended ASCII accented characters come after all a-z characters, in a French locale the accented characters are in their dictionary order for the string comparison.

:The FM function stricoll is just a wrapper around the Microsoft-specific [_stricoll] function.

== See Also ==

:strcmp, stricoll, strncoll, strnicoll