strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen_mbstrlen_l

Ottiene la lunghezza di una stringa, usando le impostazioni locali correnti o le impostazioni locali specificate. Sono disponibili versioni più sicure di queste funzioni; vedere strnlen, strnlen_s, wcsnlen, wcsnlen_s_mbsnlen, _mbsnlen_l, , _mbstrnlen_mbstrnlen_l

Sintassi

size_t strlen(
   const char *str
);
size_t wcslen(
   const wchar_t *str
);
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
);

Parametri

str
Stringa con terminazione Null.

locale
Impostazioni locali da usare.

Valore restituito

Ognuna di queste funzioni restituisce il numero di caratteri in str, escluso il terminale Null. Non è riservato alcun valore per indicare un errore, ad eccezione di _mbstrlen e _mbstrlen_l, che restituiscono ((size_t)(-1)) se la stringa contiene un carattere multibyte non valido.

Osservazioni:

strlen interpreta la stringa come stringa di caratteri a byte singolo. Il valore restituito sarà quindi sempre uguale al numero di byte, anche se la stringa contiene caratteri multibyte. wcslen è una versione a caratteri wide di strlen. L'argomento di wcslen è una stringa a caratteri wide e il conteggio di caratteri è espresso in caratteri wide (a due byte). In caso contrario,wcslen e strlen si comportano in modo identico.

Nota sulla sicurezza Queste funzioni sono esposte a una potenziale minaccia dovuta a un problema di sovraccarico del buffer. I problemi di sovraccarico del buffer sono usati spesso come metodo di attacco di sistema e provocano un'elevazione dei privilegi non autorizzata. Per altre informazioni, vedere Evitare sovraccarichi del buffer.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

_mbslen e _mbslen_l restituiscono il numero di caratteri multibyte in una stringa di caratteri multibyte, ma non testano la validità dei caratteri multibyte. _mbstrlen e _mbstrlen_l testano la validità dei caratteri multibyte e riconoscono le sequenze di caratteri multibyte. Se la stringa passata a _mbstrlen o _mbstrlen_l contiene un carattere multibyte non valido per la tabella codici, la funzione restituirà -1 e imposterà errno su EILSEQ.

Il valore di output è interessato dall'impostazione dell'impostazione LC_CTYPE della categoria delle impostazioni locali. Per ulteriori informazioni, vedere setlocale. Le versioni di queste funzioni senza il suffisso _l usano le impostazioni locali correnti per questo comportamento dipendente dalle impostazioni locali. Le versioni con il suffisso _l sono identiche ma usano il parametro passato relativo alle impostazioni locali. Per altre informazioni, vedere Locale.

Requisiti

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// 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) );

   // wcslen 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) );

}

Length of 'Count.' : 6
Length of 'Count.' : 6
Length of 'ABCァD' : 5
Length of 'ABCァD' : 5
Bytes in 'ABCァD' : 6

Vedi anche

Manipolazione delle stringhe
Interpretazione di sequenze di caratteri multibyte
impostazioni locali
setlocale, _wsetlocale
strcat, wcscat, _mbscat
strcmp, wcscmp, _mbscmp
Funzioni strcoll
strcpy, wcscpy, _mbscpy
strrchr, wcsrchr, _mbsrchr_mbsrchr_l
_strset, _strset_l, _wcsset, _wcsset_l, _mbsset_mbsset_l
strspn, wcsspn, _mbsspn_mbsspn_l