strcoll

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für Zeichenketten

Null-terminierte Byte-Strings

Null-terminierte Multibyte-Strings

Null-terminierte breite Zeichenketten

 

Null-terminierte Byte-Strings

Funktionen
Zeichenmanipulation
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
Konvertierungen zu und von numerischen Formaten
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtouimax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
Stringmanipulation
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
Stringuntersuchung
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
Speichermanipulation
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
Sonstiges
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

Definiert in Header <string.h>
int strcoll( const char* lhs, const char* rhs );

Vergleicht zwei nullterminierte Byte-Strings gemäß der aktuellen Locale, wie sie durch die LC_COLLATE-Kategorie definiert ist.

Parameter

lhs, rhs

-

Zeiger auf die zu vergleichenden nullterminierten Byte-Strings

Rückgabewert

• Negativer Wert, wenn lhs kleiner als (vor) rhs ist.
• ​0​, wenn lhs gleich rhs ist.
• Positiver Wert, wenn lhs größer als (nach) rhs ist.

Hinweise

Die Sortierreihenfolge ist die alphabetische Reihenfolge: Die Position des Buchstabens im nationalen Alphabet (seine Äquivalenzklasse) hat Vorrang vor seiner Groß-/Kleinschreibung oder Variante. Innerhalb einer Äquivalenzklasse werden Kleinbuchstaben vor ihren Großbuchstaben-Äquivalenten sortiert, und die lokalabhängige Reihenfolge kann für Zeichen mit diakritischen Zeichen gelten. In einigen Locales werden Zeichengruppen als einzelne Sortiereinheiten verglichen. Zum Beispiel folgt "ch" im Tschechischen auf "h" und geht "i" voraus, und "dzs" im Ungarischen folgt auf "dz" und geht "g" voraus.

Beispiel

Führen Sie diesen Code aus

#include <locale.h>
#include <stdio.h>
#include <string.h>
 
int main(void)
{
    setlocale(LC_COLLATE, "cs_CZ.utf8");
    // Alternatively, ISO-8859-2 (a.k.a. Latin-2)
    // may also work on some OS:
    // setlocale(LC_COLLATE, "cs_CZ.iso88592");
 
    const char* s1 = "hrnec";
    const char* s2 = "chrt";
 
    printf("In the Czech locale: ");
    if (strcoll(s1, s2) < 0)
        printf("%s before %s\n", s1, s2);
    else
        printf("%s before %s\n", s2, s1);
 
    printf("In lexicographical comparison: ");
    if (strcmp(s1, s2) < 0)
        printf("%s before %s\n", s1, s2);
    else
        printf("%s before %s\n", s2, s1);
}

Ausgabe

In the Czech locale: hrnec before chrt
In lexicographical comparison: chrt before hrnec

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.24.4.3 Die Funktion strcoll (p: TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.24.4.3 Die Funktion strcoll (p: TBD)

• C11-Standard (ISO/IEC 9899:2011)

• 7.24.4.3 Die Funktion strcoll (p: 366)

• C99-Standard (ISO/IEC 9899:1999)

• 7.21.4.3 Die Funktion strcoll (p: 329)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.11.4.3 Die Funktion strcoll

Siehe auch

wcscoll (C95)	vergleicht zwei breite Zeichenketten gemäß der aktuellen Locale (Funktion)
strxfrm	transformiert einen String so, dass strcmp dasselbe Ergebnis wie strcoll liefert (Funktion)
wcsxfrm (C95)	transformiert einen Wide-String, sodass wcscmp das gleiche Ergebnis wie wcscoll liefert (Funktion)
strcmp	vergleicht zwei Strings (Funktion)
C++ Dokumentation für strcoll