wcscmp

Compare deux chaînes larges terminées par un nul de manière lexicographique.

Le signe du résultat est le signe de la différence entre les valeurs de la première paire de caractères larges qui diffèrent dans les chaînes comparées.

Le comportement n'est pas défini si lhs ou rhs ne sont pas des pointeurs vers des chaînes de caractères larges terminées par un caractère nul.

Paramètres

Valeur de retour

Valeur négative si lhs apparaît avant rhs dans l'ordre lexicographique.

Zéro si lhs et rhs sont égaux.

Valeur positive si lhs apparaît après rhs dans l'ordre lexicographique.

Notes

Cette fonction n'est pas sensible aux paramètres régionaux, contrairement à wcscoll , et l'ordre peut ne pas être significatif lorsque des caractères de différents blocs Unicode sont utilisés ensemble ou lorsque l'ordre des unités de code ne correspond à aucun ordre de collation.

Exemple

#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);
}

[どうもありがとうございます] follows [どうも]
[どうもありがとうございます] precedes [助かった]
[ざいます] equals [ざいます]

Références

Voir aussi