strcoll()

strcoll ist definiert in der string, die in C über string.h, bzw. in C++ über cstring eingebunden wird.

Funktion

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().

Signatur

#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

Fehlerquellen

Beide Strings müssen mit einem Nullbyte abgeschlossen werden.

Beispiel

FIXME

siehe auch