wcscmp
| Definiert in Header <wchar.h> |
||
| int wcscmp( const wchar_t* lhs, const wchar_t* rhs ); |
(seit C95) | |
Vergleicht zwei nullterminierte Breitzeichenketten lexikographisch.
Das Vorzeichen des Ergebnisses ist das Vorzeichen der Differenz zwischen den Werten des ersten Paares von Breitzeichen, die sich in den verglichenen Zeichenketten unterscheiden.
Das Verhalten ist undefiniert, wenn lhs oder rhs keine Zeiger auf nullterminierte Breitzeichenketten sind.
Inhalt |
[bearbeiten] Parameter
| lhs, rhs | - | Zeiger auf die zu vergleichenden nullterminierten Breitzeichenketten |
[bearbeiten] Rückgabewert
Negativer Wert, wenn lhs lexikographisch vor rhs kommt.
Null, wenn lhs und rhs gleich verglichen werden.
Positiver Wert, wenn lhs lexikographisch nach rhs kommt.
[bearbeiten] Hinweise
Diese Funktion ist nicht gebietsschema-abhängig, im Gegensatz zu wcscoll, und die Reihenfolge ist möglicherweise nicht aussagekräftig, wenn Zeichen aus verschiedenen Unicode-Blöcken zusammen verwendet werden oder wenn die Reihenfolge der Code-Einheiten keiner Sortierreihenfolge entspricht.
[bearbeiten] Beispiel
#include <locale.h> #include <stdio.h> #include <wchar.h> void demo(const wchar_t* lhs, const wchar_t* rhs) { int rc = wcscmp(lhs, rhs); const char *rel = rc < 0 ? "precedes" : rc > 0 ? "follows" : "equals"; setlocale(LC_ALL, "en_US.utf8"); printf("[%ls] %s [%ls]\n", lhs, rel, rhs); } int main(void) { const wchar_t* string = L"どうもありがとうございます"; demo(string, L"どうも"); demo(string, L"助かった"); demo(string + 9, L"ありがとうございます" + 6); }
Mögliche Ausgabe
[どうもありがとうございます] follows [どうも] [どうもありがとうございます] precedes [助かった] [ざいます] equals [ざいます]
[bearbeiten] Referenzen
- C23-Standard (ISO/IEC 9899:2024)
- 7.29.4.4.1 Die Funktion wcscmp (p: TBD)
- C17-Standard (ISO/IEC 9899:2018)
- 7.29.4.4.1 Die Funktion wcscmp (p: TBD)
- C11-Standard (ISO/IEC 9899:2011)
- 7.29.4.4.1 Die Funktion wcscmp (p: 433)
- C99-Standard (ISO/IEC 9899:1999)
- 7.24.4.4.1 Die Funktion wcscmp (p: 379)
[bearbeiten] Siehe auch
| (C95) |
vergleicht eine bestimmte Anzahl von Zeichen aus zwei breiten Zeichenketten (Funktion) |
| (C95) |
vergleicht eine bestimmte Anzahl breiter Zeichen aus zwei Arrays (Funktion) |
| vergleicht zwei Strings (Funktion) | |
| (C95) |
vergleicht zwei breite Zeichenketten gemäß der aktuellen Locale (Funktion) |
| C++-Dokumentation für wcscmp
| |
