Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

wcsncmp — comparaison bornée de caractères larges

wcsncmp compare au plus n éléments wchar_t. Le résultat indique l’ordre ou l’égalité de la partie comparée, pas nécessairement des chaînes entières.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);

wcsncmp, déclaré dans <wchar.h>, compare au plus n caractères larges. Les caractères qui suivent L'\0' ne sont pas comparés. La première paire de caractères différents dans la comparaison détermine le signe du résultat, mais le langage C ne garantit pas que l’implémentation cesse de lire à cette paire. La limite compte les éléments wchar_t, et non les octets.

Un résultat négatif, nul ou positif signifie que la partie comparée est respectivement inférieure, égale ou supérieure. Testez le signe, pas les valeurs exactes -1 ou 1. L’ordre dépend des valeurs des caractères, et non des règles de collation de la locale.

Pour n == 0, le résultat est nul ; fournissez tout de même des pointeurs valides. Chaque tableau doit fournir au moins n éléments ou contenir un caractère de fin L'\0' parmi ses éléments disponibles. Ne comptez pas sur une différence précoce pour passer un tableau plus court sans caractère de fin. Des préfixes égaux ne prouvent pas que les chaînes entières sont égales.

Exemples

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    const wchar_t a[] = L"cat";
    const wchar_t b[] = L"car";

    printf("prefix_equal=%d\n", wcsncmp(a, b, 2) == 0);
    printf("whole_equal=%d\n", wcsncmp(a, b, 3) == 0);
    printf("zero_equal=%d\n", wcsncmp(a, b, 0) == 0);
    return 0;
}

Résultat

prefix_equal=1
whole_equal=0
zero_equal=1

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources