strlen, strlen_l, wcslen, wcslen_l, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l

Article
03/26/2013

Obtient la longueur d'une chaîne, à l'aide de les paramètres régionaux ou des paramètres régionaux spécifiés.Les versions sécurisées de ces fonctions sont disponibles ; consultez strnlen, les strnlen_s, strnlen_l, wcsnlen, les wcsnlen_s, wcsnlen_l, _mbsnlen, _mbsnlen_l, _mbstrnlen, _mbstrnlen_l

Important

_mbslen, _mbslen_l, _mbstrlen, et _mbstrlen_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

size_t strlen(
   const char *str
);
size_t strlen_l(
   const char *str,
   _locale_t locale 
);
size_t wcslen(
   const wchar_t *str 
);
size_t wcslen_l(
   const wchar_t *str,
   _locale_t locale
);
size_t _mbslen(
   const unsigned char *str 
);
size_t _mbslen_l(
   const unsigned char *str,
   _locale_t locale
);
size_t _mbstrlen(
   const char *str
);
size_t _mbstrlen_l(
   const char *str,
   _locale_t locale
);

Paramètres

str
Chaîne terminée par le caractère NULL.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Chacune de ces fonctions retourne le nombre de caractères dans str, à l'exclusion de NULLfeuille.Aucune valeur de retour n'est réservée pour indiquer une erreur, à l'exception _mbstrlen, qui retourne ((size_t)(-1)) si la chaîne contient un caractère multioctet incorrect.

Notes

strlen interprète la chaîne comme une chaîne de caractères codé sur un octet, donc sa valeur de retour est toujours égale au nombre d'octets, même si la chaîne contient des caractères multioctets.wcslen est une version à caractère élargi d' strlen; l'argument d' wcslen est une chaîne à caractères larges et le nombre de caractères est caractères (à deux octets) larges.wcslen et strlen se comportent de sinon.

Remarque sur la sécurité ces fonctions entraînent un risque potentiel provoqué par un dépassement de mémoire tampon.Les dépassements de mémoire tampon sont une méthode fréquente d'attaque de système, ce qui provoque une élévation de privilège injustifiée.Pour plus d'informations, consultez l' Solutions contre les dépassements de mémoire tampon.

Mappages de routines de texte générique

Routine de TCHAR.H	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_tcslen	strlen	strlen	wcslen
_tcsclen	strlen	_mbslen	wcslen
_tcsclen_l	strlen_l	_mbslen_l	wcslen_l

_mbslen,_mbslen_l, _mbstrlenetle retour d'_mbstrlen_l le nombre de caractères multioctets dans une chaîne de caractères multioctets mais elles ne déterminent pas la validité à caractères multioctets._mbstrlenet_mbstrlen_l détermine la validité à caractères multioctets et identifie les séquences de caractères multioctetssetlocale, _wsetlocale.Si la chaîne passée à _mbstrlen ou_mbstrlen_l contiennent un caractère multioctet incorrect pour la page de codes, elle retourne -1 et définit errno à EILSEQ.

La valeur de sortie est affectée par la configuration de la définition de catégorie d' LC_CTYPE des paramètres régionaux ; consultez l' setlocale pour plus d'informations.Les versions de ces fonctions sans suffixe d' _l utilisent les paramètres régionaux définis pour ce comportement dépendant des paramètres régionaux ; les versions avec le suffixe d' _l sont identiques sauf qu'elles utilisent le paramètre de paramètres régionaux passé à la place.Pour plus d'informations, consultez Paramètres régionaux.

Configuration requise

Routine	En-tête requis
strlen	<string.h>
strlen_l	<string.h>
wcslen, wcslen_l	<string.h> ou <wchar.h>
_mbslen, _mbslen_l	<mbstring.h>
_mbstrlen, _mbstrlen_l	<stdlib.h>

Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.

Exemple

// crt_strlen.c
// Determine the length of a string. For the multi-byte character
// example to work correctly, the Japanese language support for
// non-Unicode programs must be enabled by the operating system.


#include <string.h>
#include <locale.h>

int main()
{
   char* str1 = "Count.";
   wchar_t* wstr1 = L"Count.";
   char * mbstr1;
   char * locale_string;

   // strlen gives the length of single-byte character string
   printf("Length of '%s' : %d\n", str1, strlen(str1) );

   // wstrlen gives the length of a wide character string
   wprintf(L"Length of '%s' : %d\n", wstr1, wcslen(wstr1) );

   // A multibyte string: [A] [B] [C] [katakana A] [D] [\0]
   // in Code Page 932. For this example to work correctly,
   // the Japanese language support must be enabled by the
   // operating system.
   mbstr1 = "ABC" "\x83\x40" "D";

   locale_string = setlocale(LC_CTYPE, "Japanese_Japan");

   if (locale_string == NULL)
   {
      printf("Japanese locale not enabled. Exiting.\n");
      exit(1);
   }
   else
   {
      printf("Locale set to %s\n", locale_string);
   }

   // _mbslen will recognize the Japanese multibyte character if the
   // current locale used by the operating system is Japanese
   printf("Length of '%s' : %d\n", mbstr1, _mbslen(mbstr1) );

   // _mbstrlen will recognize the Japanese multibyte character
   // since the CRT locale is set to Japanese even if the OS locale
   // isnot. 
   printf("Length of '%s' : %d\n", mbstr1, _mbstrlen(mbstr1) );
   printf("Bytes in '%s' : %d\n", mbstr1, strlen(mbstr1) );   
  
}