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

發行項
03/26/2013

使用目前的地區設定或指定的地區設定，取得字串的長度，。這些函式更安全版本可用的;請參閱 strnlen、 strnlen_s、 strnlen_l、 wcsnlen、 wcsnlen_s、 wcsnlen_l、 _mbsnlen、 _mbsnlen_l、 _mbstrnlen、 _mbstrnlen_l。

重要

_mbslen、 _mbslen_l、 _mbstrlen和 _mbstrlen_l 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 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 其餘行為相同。

安全性提示 這些函式會導致緩衝區滿溢問題達到的潛在的威脅。緩衝區溢位問題是系統攻擊的常見方法，它會導致權限不確定性的增加。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

泛用文字常式對應

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>

如需其他相容性資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

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