strlen, strlen_l, wcslen, wcslen_l, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l
Získáte délku řetězce pomocí aktuální národní prostředí nebo zadané národní prostředí.Bezpečnější verze tyto funkce jsou k dispozici; Vizstrnlen, strnlen_s, strnlen_l, wcsnlen, wcsnlen_s, wcsnlen_l, _mbsnlen, _mbsnlen_l, _mbstrnlen, _mbstrnlen_l
![]() |
---|
_mbslen, _mbslen_l, _mbstrlen, a _mbstrlen_l nelze použít v aplikacích, které jsou spuštěny v systému Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /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
);
Parametry
str
Řetězec zakončený hodnotou Null.locale
Chcete-li národní prostředí pro použití.
Vrácená hodnota
Každá z těchto funkcí vrací počet znaků v str, s výjimkou terminálu NULL.Žádné vrácená hodnota je rezervován pro označení chybu, s výjimkou _mbstrlen, která vrátí ((size_t)(-1)) Pokud řetězec obsahuje neplatný vícebajtových znaků.
Poznámky
strleninterpretuje řetězec jako jednobajtové znakové řetězce, takže její vrácená hodnota je rovna počtu bajtů, vždy i v případě, že řetězec obsahuje vícebajtové znaky.wcslenje verzí širokého znaku strlen; argument wcslen řetězce širokého znaku a počet znaků v široké (dvoubajtový) znaky.wcslena strlen jinak chovat identicky.
Poznámka: zabezpečení tyto funkce při rozloženém potenciální ohrožení vyvolaných problému přetečení vyrovnávací paměti.Přetečení vyrovnávací paměti potíže jsou používaný způsob útoku systému, výsledkem bude vyplacena neoprávněně zvýšení úrovně oprávnění.Další informace naleznete v tématu Zamezení způsobí přetečení vyrovnávací paměti.
Mapování rutiny obecného textu
TCHAR.Byla zahájena rutina h |
_UNICODE & _MBCS není definováno |
_MBCS, definice |
_UNICODE definována |
---|---|---|---|
_tcslen |
strlen |
strlen |
wcslen |
_tcsclen |
strlen |
_mbslen |
wcslen |
_tcsclen_l |
strlen_l |
_mbslen_l |
wcslen_l |
_mbslen,_mbslen_l, _mbstrlen a _mbstrlen_l vrácení počtu vícebajtových znaků vícebajtové znakové řetězce, ale nikoli test platnosti vícebajtové znakové._mbstrlena _mbstrlen_l ověří platnost vícebajtové znakové a rozpozná vícebajtové znakové sekvencesetlocale _wsetlocale.Pokud řetězec předaný _mbstrlen nebo _mbstrlen_l obsahovat neplatné vícebajtové znakové stránky kód vrátí hodnotu -1 a sady errno na EILSEQ.
Výstupní hodnota je ovlivněna nastavením LC_CTYPE kategorie nastavení národního prostředí; Viz setlocale pro další informace.Verze těchto funkcí, aniž by _l příponu použít aktuální národní prostředí pro toto chování závislé na národním prostředí; verze s _l s tím rozdílem, že používají místo něho předán parametr locale shodná přípona.Další informace naleznete v tématu Národní prostředí.
Požadavky
Byla zahájena rutina |
Požadované záhlaví |
---|---|
strlen |
<string.h> |
strlen_l |
<string.h> |
wcslen, wcslen_l |
<string.h> nebo <wchar.h> |
_mbslen, _mbslen_l |
<mbstring.h> |
_mbstrlen, _mbstrlen_l |
<stdlib.h> |
Další informace o kompatibilitě, viz Compatibility v úvodu.
Příklad
// 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) );
}
Ekvivalent v rozhraní .NET Framework
Viz také
Referenční dokumentace
Výklad vícebajtové znakové sekvence
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l