strcoll ist definiert in der string
, die in C über string.h
, bzw. in C++ über cstring
eingebunden wird.
strcoll() vergleicht zwei Strings und gibt aus, welcher String größer ist. Hierbei wird entsprechend der locale-Einstellungen (siehe setlocale()) unter Verwendung on LC:COLLATE) entschieden, wie große und kleine Buchstaben verglichen werden, also ob ein kleiner Buchstabe größer als der entsprechende große Buchstabe ist, ob er gleichwertig oder kleiner ist. Die Funktion vergleicht Buchstabe für Buchstabe der jeweiligen Strings und endet, sobald bei mindestens einem String ein Null-Byte gefunden wurde. Bis auf die Berücksichtigung der Groß-/Kleinschreibung entspricht strcoll() damit strcmp().
#include <string.h> int strcoll( char const * first, char const * second );
first: erster String
second: zweiter, zu vergleichender Speicherblock
Return value: Ein Integer, das wie folgt interpretiert wird
Rückgabewert | Bedeutung |
---|---|
0 | Die verglichenen Zeichen hatten identische Werte |
> 0 | Die verglichenen Zeichen waren nicht identisch, der erste unterschiedliche Wert war bei first größer als bei second |
< 0 | Die verglichenen Zeichen waren nicht identisch, der erste unterschiedliche Wert war bei first kleiner als bei second |
Beide Strings müssen mit einem Nullbyte abgeschlossen werden.