wcslen, wcsnlen_s

ヘッダー `<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 がヌルポインタの場合はゼロを返し、src の最初の strsz ワイド文字内にヌルワイド文字が見つからなかった場合は strsz を返します。

すべての境界チェックされた関数と同様に、wcslen_s は、実装によって __STDC_LIB_EXT1__ が定義されており、ユーザーが <stdio.h> をインクルードする前に __STDC_WANT_LIB_EXT1__ を整数定数 1 に定義した場合にのみ利用できることが保証されます。

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++ ドキュメント ( wcslen )

コンパイラサポート
言語
ヘッダー
型サポート
プログラムユーティリティ
可変長引数関数のサポート
エラーハンドリング
動的メモリ管理
文字列ライブラリ
アルゴリズム
数値
日付と時刻のユーティリティ
入出力サポート
ローカライゼーションサポート
並行処理サポート (C11)
技術仕様
シンボルインデックス

cppreference.com

名前空間

変種

表示

操作

wcslen, wcsnlen_s

目次

[編集] パラメータ

[編集] 戻り値

[編集] 備考

[編集] 例

[編集] 参照

[編集] 関連項目

ナビゲーション

ツールボックス

str	-	検査するヌル終端ワイド文字列へのポインタ
strsz	-	検査するワイド文字の最大数