Your Browser is not longer supported
Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...
{{viewport.spaceProperty.prod}}
strcoll - Zeichenketten nach Sortierreihenfolge vergleichen
&pagelevel(4)&pagelevel
Definition | #include <string.h> int strcoll(const char *s1, const char *s2); |
Beschreibung | strcoll() liefert eine ganze Zahl, die größer, kleiner oder gleich null ist, abhängig davon, ob die Zeichenkette s1 größer, gleich oder kleiner als die Zeichenkette s2 ist. Der Vergleich der Zeichenketten hängt davon ab, wie die Kategorie LC_COLLATE der jeweiligen lokalen Umgebung eingestellt ist (siehe setlocale() ).
Mit strcoll() und strxfrm() können Zeichenketten umgebungsabhängig sortiert werden. strcoll() ist für Anwendungen gedacht, bei denen die Anzahl der Vergleiche pro Zeichenkette gering ist. Wenn Zeichenketten oft verglichen werden, sollte strxfrm() zusammen mit strcmp() so verwendet werden, dass der Transformationsprozess nur einmal stattfindet. |
Returnwert | Ganzzahliger Wert, und zwar: |
| < 0 | s1 ist lexikalisch kleiner als s2. |
| = 0 | s1 und s2 sind lexikalisch gleich groß. |
| > 0 | s1 ist lexikalisch größer als s2. |
Fehler | strcoll() schlägt fehl, wenn gilt:
|
| EINVAL
| Die Argumente s1 oder s2 enthalten Zeichen, die außerhalb des Definitionsbereichs der Sortierreihenfolge liegen. |
Hinweise | Als Argumente werden Zeichenketten erwartet, die mit dem Nullbyte (\0 ) abgeschlossen sind. Da strcoll() keinen Returnwert für die Anzeige eines Fehlers zurückgibt, können Fehler nur wie folgt festgestellt werden: errno wird auf 0 gesetzt; anschließend wird die Funktion aufgerufen und errno geprüft. Wenn errno ungleich 0 ist, muss ein Fehler aufgetreten sein. |
Siehe auch | setlocale() , strcmp() , strxfrm() , string.h .
|