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
Importante
Non è possibile usare _mbslen, _mbslen_l, _mbstrlen e _mbstrlen_l in applicazioni eseguite in Windows Runtime.Per altre informazioni, vedere l'argomento relativo alle funzioni CRT non supportate con /ZW.
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 NULL terminale. 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.
Note
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 possono incorrere in una minaccia potenziale 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.
Mapping di routine di testo generico
Routine TCHAR.H |
_UNICODE e _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
---|---|---|---|
_tcslen |
strlen |
strlen |
wcslen |
_tcsclen |
strlen |
_mbslen |
wcslen |
_tcsclen_l |
strlen |
_mbslen_l |
wcslen |
_mbslen e _mbslen_l restituiscono il numero di caratteri multibyte in una stringa a 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 dalla configurazione dell'impostazione della categoria LC_CTYPE delle impostazioni locali. Per altre 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 Impostazioni locali.
Requisiti
Routine |
Intestazione obbligatoria |
---|---|
strlen |
<string.h> |
wcslen |
<string.h> o <wchar.h> |
_mbslen, _mbslen_l |
<mbstring.h> |
_mbstrlen, _mbstrlen_l |
<stdlib.h> |
Per altre informazioni sulla compatibilità, vedere 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) );
// 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) );
}
Equivalente .NET Framework
Vedere anche
Riferimenti
Interpretazione di sequenze di caratteri multibyte
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l