wcslen, wcsnlen_s

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

字串庫

空終止位元組字串

空終止多位元組字串

空終止寬字串

 

空終止寬字串

函式 字元分類 iswalnum (C95) iswalpha (C95) iswlower (C95) iswupper (C95) iswdigit (C95) iswxdigit (C95)   iswblank (C99) iswctype (C95) iswcntrl (C95) iswgraph (C95) iswspace (C95) iswprint (C95) iswpunct (C95) wctype (C95) 字元操作 towlower (C95) towupper (C95) wctrans (C95) towctrans (C95) 轉換為數字格式 wcstolwcstoll (C95)(C99) wcstofwcstodwcstold (C99)(C95)(C99) wcstoulwcstoull (C95)(C99) wcstoimaxwcstoumax (C99)(C99)     字串操作 wcscpywcscpy_s (C95)(C11) wcsncpywcsncpy_s (C95)(C11) wcsxfrm (C95) wcscatwcscat_s (C95)(C11) wcsncatwcsncat_s (C95)(C11)

字串檢查 wcslenwcsnlen_s (C95)(C11) wcsstr (C95) wcscmp (C95) wcsncmp (C95) wcscoll (C95) wcschr (C95) wcsrchr (C95) wcspbrk (C95) wcsspn (C95) wcscspn (C95) wcstokwcstok_s (C95)(C11) 陣列操作 wmemcpywmemcpy_s (C95)(C11) wmemmovewmemmove_s (C95)(C11)   wmemcmp (C95) wmemchr (C95) wmemset (C95) 型別 wchar_t wint_t (C95) wctrans_t wctype_t (C95)(C95) 宏 WCHAR_MIN WCHAR_MAX (C95)(C95) WEOF (C95)

 

在標頭檔案 <wchar.h> 中定義
size_t wcslen( const wchar_t *str );	(1)	(自 C95 起)
size_t wcsnlen_s(const wchar_t *str, size_t strsz);	(2)	(C11 起)

1) 返回寬字串的長度，即終止空寬字元之前非空寬字元的數量。

2) 與 (1) 相同，但如果 str 是空指標則返回零，如果在前 strsz 個寬字元中未找到空寬字元則返回 strsz。

與所有邊界檢查函式一樣，只有當實現定義了 __STDC_LIB_EXT1__ 且使用者在包含 <stdio.h> 之前將 __STDC_WANT_LIB_EXT1__ 定義為整數常量 1 時，才能保證 wcslen_s 可用。

引數

str	-	指向要檢查的以空字元終止的寬字串的指標
strsz	-	要檢查的最大寬字元數

返回值

1) 以空字元終止的寬字串 str 的長度。

2) 成功時返回以空字元終止的寬字串 str 的長度，如果 str 是空指標則返回零，如果未找到空寬字元則返回 strsz。

注意

strnlen_s 和 wcsnlen_s 是唯一不呼叫執行時約束處理程式的邊界檢查函式。它們是純實用函式，用於為非空終止字串提供有限支援。

示例

執行此程式碼

#include <wchar.h>
#include <stdio.h>
 
int main(void)
{
    wchar_t str[] = L"How many wide characters does this string contain?";
 
    printf("without null character: %zu\n", wcslen(str));
    printf("with null character: %zu\n", sizeof str / sizeof *str);
}

輸出

without null character: 50
with null character: 51

參考

• C11 標準 (ISO/IEC 9899:2011)

• 7.29.4.6.1 wcslen 函式 (p: 439)

• K.3.9.2.4.1 wcsnlen_s 函式 (p: 646-647)

• C99 標準 (ISO/IEC 9899:1999)

• 7.24.4.6.1 wcslen 函式 (p: 385)

另請參閱

strlenstrnlen_s (C11)	返回給定字串的長度 (函式)
C++ 文件 for wcslen