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

项目
04/10/2013

获取一个字符串的长度，使用当前区域设置或指定的区域设置。这些功能的更安全版本可用；请参见 strnlen， strnlen_s， strnlen_l， wcsnlen， wcsnlen_s， wcsnlen_l， _mbsnlen， _mbsnlen_l， _mbstrnlen， _mbstrnlen_l

重要

_mbslen、_mbslen_l、_mbstrlen和 _mbstrlen_l 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /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
);

参数

str
null 终止的字符串。
locale
使用的区域设置。

返回值

这些函数都返回一个字符数。str的，不包括最终 NULL。没有任何返回值保留指示错误，但 _mbstrlen，返回 ((size_t)(-1))，如果该字符串包含无效的多字节字符。

备注

strlen 解释字符串作为单字节字符字符串，因此，其返回值与字节数总是相同的，因此，即使该字符串包含一个多字节字符。 wcslen 是 strlen的宽字符版本；wcslen 的参数是宽字符字符串，以及计算字符在宽 (双字节) 字符。 wcslen 和 strlen 否则具有相同的行为。

安全说明" 这些功能会导致缓冲区溢出问题实现的潜在的威胁。缓冲区溢出问题是系统攻击一个常见的方案，使权限的非确保提升。有关更多信息，请参见避免缓冲区溢出。

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_tcslen	strlen	strlen	wcslen
_tcsclen	strlen	_mbslen	wcslen
_tcsclen_l	strlen_l	_mbslen_l	wcslen_l

_mbslen、_mbslen_l、_mbstrlen和_mbstrlen_l 返回多字节字符数在多字节字符字符串的，但不测试多字节字符的有效性。 _mbstrlen和_mbstrlen_l 测试多字节字符有效性并识别多字节字符序列setlocale， _wsetlocale。如果该字符串传递给 _mbstrlen 或_mbstrlen_l 包含代码页的无效多字节字符，则返回 -1 并将 errno 到 EILSEQ。

输出值受设置 LC_CTYPE 类设置的影响区域设置；请参见 setlocale 有关更多信息。这些功能的版本不 _l 后缀为该区域设置相关的行为使用当前区域设置；与 _l 后缀的版本相同，只不过它们使用传入的区域设置参数。有关更多信息，请参见区域设置。

要求

实例	必需的标头
strlen	<string.h>
strlen_l	<string.h>
wcslen, wcslen_l	<string.h> 或 <wchar.h>
_mbslen, _mbslen_l	<mbstring.h>
_mbstrlen, _mbstrlen_l	<stdlib.h>

有关其他的兼容性信息，请参见中介绍的兼容性。

示例

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