Namespaces
Variants

wcslen, wcsnlen_s

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
Défini dans l'en-tête <wchar.h>
size_t wcslen ( const wchar_t * str ) ;
(1) (depuis C95)
size_t wcsnlen_s ( const wchar_t * str, size_t strsz ) ;
(2) (depuis C11)
1) Retourne la longueur d'une chaîne large, c'est-à-dire le nombre de caractères larges non nuls qui précèdent le caractère large nul de fin.
2) Identique à (1) , sauf que la fonction renvoie zéro si str est un pointeur nul et renvoie strsz si le caractère large nul n'a pas été trouvé dans les premiers strsz caractères larges de src
Comme pour toutes les fonctions à vérification de limites, wcslen_s n'est garantie d'être disponible que si __STDC_LIB_EXT1__ est défini par l'implémentation et si l'utilisateur définit __STDC_WANT_LIB_EXT1__ à la constante entière 1 avant d'inclure <stdio.h> .

Table des matières

Paramètres

str - pointeur vers la chaîne large terminée par un caractère nul à examiner
strsz - nombre maximum de caractères larges à examiner

Valeur de retour

1) La longueur de la chaîne large terminée par un caractère nul str .
2) La longueur de la chaîne large terminée par un caractère nul str en cas de succès, zéro si str est un pointeur nul, strsz si le caractère large nul n'a pas été trouvé.

Notes

strnlen_s et wcsnlen_s sont les seules fonctions à vérification de limites qui n'invoquent pas le gestionnaire de contraintes d'exécution. Ce sont des fonctions utilitaires pures utilisées pour fournir un support limité aux chaînes de caractères non terminées par un caractère nul.

Exemple

Exécuter ce code 
#include <wchar.h>
#include <stdio.h>
int main(void)
{
    wchar_t str[] = L"How many wide characters does this string contain?";
    printf("without null character: %zu\n", wcslen(str));
    printf("with null character: %zu\n", sizeof str / sizeof *str);
}

Sortie : 

without null character: 50
with null character: 51

Références

  • Norme C11 (ISO/CEI 9899:2011) :
  • 7.29.4.6.1 La fonction wcslen (p: 439)
  • K.3.9.2.4.1 La fonction wcsnlen_s (p: 646-647)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.24.4.6.1 La fonction wcslen (p: 385)

Voir aussi

(C11)
retourne la longueur d'une chaîne donnée
(fonction)
Documentation C++ pour wcslen