_strncnt、_wcsncnt、_mbsnbcnt、_mbsnbcnt_l、_mbsnccnt、_mbsnccnt_l
指定された計算内の文字数またはバイト数を返します。
.gif "重要 :") 重要 |
|---|
_mbsnbcnt、_mbsnbcnt_l、_mbsnccntと _mbsnccnt_l は、Windows のランタイムで実行するアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
size_t _strncnt(
const char *str,
size_t count
);
size_t _wcsncnt(
const wchar_t *str,
size_t count
);
size_t _mbsnbcnt(
const unsigned char *str,
size_t count
);
size_t _mbsnbcnt_l(
const unsigned char *str,
size_t count,
_locale_t locale
);
size_t _mbsnccnt(
const unsigned char *str,
size_t count
);
size_t _mbsnccnt_l(
const unsigned char *str,
size_t count,
_locale_t locale
);
パラメーター
str
チェックする文字列。count
strでチェックする文字数またはバイト数。locale
使用するロケール。
戻り値
_mbsnbcnt と _mbsnbcnt_l は strのマルチバイト文字の最初の count にあるバイト数を返します。_mbsnccnt と _mbsnccnt_l は strバイトの最初の count で検索文字数を返します。str のチェックが完了する前に Null 文字が検出された場合、バイト数を返しますまたは文字は Null 文字の前に見つかりました。str が count の文字とバイト数よりも少ないで構成されている場合は、文字列の文字数またはバイト数を返します。count がゼロより小さい場合、これらは 0 を返します。以前のバージョンでは、これらの関数に size_tはなく、型 int の戻り値がありました。
_strncnt はバイト文字列 strの count の最初のバイト文字数を返します。_wcsncnt は文字列 strの count の最初のワイド文字の文字数を返します。
解説
_mbsnbcnt と _mbsnbcnt_l は strのマルチバイト文字の最初の count にあるバイト数をカウントします。_mbsnbcnt と _mbsnbcnt_l は mtob を置き換え、mtobの代わりに使用する必要があります。
_mbsnccnt と _mbsnccnt_l は strバイトの最初の count で検索文字数をカウントします。_mbsnccnt と _mbsnccnt_l がダブル バイト文字で 2 バイトの null 値が発生した場合は、最初のバイトは、NULL と見なされて返される数値に含まれません。_mbsnccnt と _mbsnccnt_l は btom を置き換え、btomの代わりに使用する必要があります。
str が null ポインターであるか、count が 0 の場合、これらの関数は パラメーターの検証に説明されているように、無効なパラメーター ハンドラーを呼び出します errno は、EINVALおよび関数の戻り値の 0 に設定されます。
出力値は、ロケールの LC_CTYPE カテゴリの設定で決まります。詳細については、「setlocale」を参照してください。_l サフィックスが付いていないこの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。詳細については、「ロケール」を参照してください。
汎用テキスト ルーチンのマップ
ルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_tcsnbcnt |
_strncnt |
_mbsnbcnt |
_wcsncnt |
_tcsnccnt |
_strncnt |
_mbsnbcnt |
n/a |
_wcsncnt |
n/a |
n/a |
_mbsnbcnt |
_wcsncnt |
n/a |
n/a |
_mbsnccnt |
n/a |
n/a |
_mbsnbcnt_l |
_mbsnccnt_l |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_mbsnbcnt |
<mbstring.h> |
_mbsnbcnt_l |
<mbstring.h> |
_mbsnccnt |
<mbstring.h> |
_mbsnccnt_l |
<mbstring.h> |
_strncnt |
<tchar.h> |
_wcsncnt |
<tchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_mbsnbcnt.c
#include <mbstring.h>
#include <stdio.h>
int main( void )
{
unsigned char str[] = "This is a multibyte-character string.";
unsigned int char_count, byte_count;
char_count = _mbsnccnt( str, 10 );
byte_count = _mbsnbcnt( str, 10 );
if ( byte_count - char_count )
printf( "The first 10 characters contain %d multibyte characters\n", char_count );
else
printf( "The first 10 characters are single-byte.\n");
}
出力
The first 10 characters are single-byte.
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。