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

Článek
06/09/2015

Získá délku řetězce, s použitím aktuální národní prostředí nebo zadané národní prostředí.Bezpečnější verze tyto funkce jsou k dispozici; Podívejte se na témastrnlen, strnlen_s, strnlen_l, wcsnlen, wcsnlen_s, wcsnlen_l, _mbsnlen, _mbsnlen_l, _mbstrnlen, _mbstrnlen_l

Důležité
_mbslen, _mbslen_l, _mbstrlen, a _mbstrlen_l nelze použít v aplikacích, které jsou spuštěny v běhovém prostředí systému Windows.Další informace naleznete v tématu CRT funkce nepodporované s /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 );

Parametry

str
Řetězec ukončený hodnotou Null.
locale
Národní prostředí má použít.

Vrácená hodnota

Každá z těchto funkcí vrátí počet znaků v str, s výjimkou Terminálové NULL.Je vyhrazen žádnou návratovou hodnotu udávající chybu, s výjimkou _mbstrlen a _mbstrlen_l, které return ((size_t)(-1)) Pokud řetězec obsahuje neplatný znak více.

Poznámky

strlenřetězec interpretuje jako řetězec znaků jednoho bajtu, takže vrácená hodnota je rovna počet bajtů, vždy i v případě, že řetězec obsahuje středník.wcslenje verze širokého znaku strlen; argument wcslen je řetězec širokého znaku a je počet znaků v celém (dva bajtů) znaků.Funkce wcslen a strlen se jinak chovají stejně.

Poznámka: zabezpečení tyto funkce utrpíte může ohrozit vyvolané problém přetečení vyrovnávací paměti.Přetečení vyrovnávací paměti problémy jsou často metoda útok systému, což bude vyplacena neoprávněně zvýšení úrovně oprávnění.Další informace naleznete v tématu Předcházení přetečení vyrovnávací paměti.

Mapování rutin obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definována.	_MBCS definováno	_UNICODE definováno
_tcslen	strlen	strlen	wcslen
_tcsclen	strlen	_mbslen	wcslen
_tcsclen_l	strlen	_mbslen_l	wcslen

_mbslena _mbslen_l vrátit počet středník v řetězci multibajtové znakové, ale není testovat multibajtové znakové platnost._mbstrlena _mbstrlen_l test platnosti multibajtové znakové a rozpoznat vícebajtové znakové sekvence.Pokud řetězec předaný _mbstrlen nebo _mbstrlen_l obsahuje neplatný znak více pro znakové stránky, funkce vrátí hodnotu -1 a nastaví errno k EILSEQ.

Výstupní hodnota nastavení má vliv LC_CTYPE kategorie nastavení národního prostředí; Podívejte se na téma setlocale Další informace.Verze pro tyto funkce bez _l přípona použít aktuální národní prostředí pro toto národní prostředí závislé chování; verze s _l přípona jsou shodné s tím rozdílem, že používají místo něho předán v parametru národní prostředí.Další informace naleznete v tématu Národní prostředí.

Požadavky

Rutina	Požadovaný hlavičkový soubor
strlen	< string.h >
wcslen	< string.h > nebo < wchar.h >
_mbslen, _mbslen_l	< mbstring.h >
_mbstrlen, _mbstrlen_l	< stdlib.h >

Další informace o kompatibilitě, naleznete v části kompatibility.

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