strpbrk、wcspbrk、_mbspbrk、_mbspbrk_l

[アーティクル]
03/26/2013

指定された文字セットの文字のスキャンの文字列。

重要
_mbspbrk と _mbspbrk_l は、Windows のランタイムで実行するアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。

char *strpbrk(
   const char *str,
   const char *strCharSet 
); // C only
char *strpbrk(
   char *str,
   const char *strCharSet 
); // C++ only
const char *strpbrk(
   const char *str,
   const char *strCharSet 
); // C++ only
wchar_t *wcspbrk(
   const wchar_t *str,
   const wchar_t *strCharSet 
); // C only
wchar_t *wcspbrk(
   wchar_t *str,
   const wchar_t *strCharSet 
); // C++ only
const wchar_t *wcspbrk(
   const wchar_t *str,
   const wchar_t *strCharSet 
); // C++ only
unsigned char *_mbspbrk(
   const unsigned char *str,
   const unsigned char *strCharSet 
); // C only
unsigned char *_mbspbrk(
   unsigned char *str,
   const unsigned char *strCharSet 
); // C++ only
const unsigned char *_mbspbrk(
   const unsigned char *str,
   const unsigned char *strCharSet 
); // C++ only
unsigned char *_mbspbrk_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
); // C only
unsigned char *_mbspbrk_l(
   unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
); // C++ only
const unsigned char *_mbspbrk_l(
   const unsigned char *str,
   const unsigned char* strCharSet,
   _locale_t locale
); // C++ only

パラメーター

str
NULL で終わる、検索文字列。
strCharSet
NULL で終わる文字セット。
locale
使用するロケール。

戻り値

2 文字列引数が共通の文字がない場合 strの strCharSet からの文字の最初の生成にポインター、または NULL のポインターを返します。

解説

strpbrk 関数は strCharSetの文字セットに属する str 内で最初に出現へのポインターを返します。検索は終端の null 文字は含まれません。

wcspbrk 関数と _mbspbrk 関数は、strpbrk 関数のワイド文字バージョンとマルチバイト文字バージョンです。wcspbrk 関数の引数と戻り値はワイド文字列で、_mbspbrk 関数の引数と戻り値はマルチバイト文字列です。

_mbspbrk は、パラメーターを検証します。str か strCharSet が NULL場合、無効なパラメーターハンドラーがパラメーターの検証に説明されているように、開始されます。実行の継続が許可された場合、_mbspbrk は NULL を返し、errno を EINVAL に設定します。strpbrk および wcspbrk は、パラメーターを検証しません。それ以外では、これらの関数の動作は同じです。

_mbspbrk は size_t型の値ではなく _mbscspn ただし、_mbspbrk のリターンポインターに似ています。

C では、これらの関数は、最初の引数に const ポインターを受け取ります。C++ では、2 つのオーバーロードを使用できます。const へのポインターを受け取るオーバーロードでは、const へのポインターが返されます。非 const へのポインターを受け取るバージョンでは、非 const へのポインターが返されます。この関数の const と非 const の両方のバージョンが使用できる場合、_CONST_CORRECT_OVERLOADS というマクロが定義されます。C++ のいずれのオーバーロードでも、非 const の動作が求められる場合は、シンボル _CONST_RETURN を定義してください。

出力値は、ロケールの LC_CTYPE カテゴリの設定で決まります。詳細については、「setlocale」を参照してください。_l のサフィックスを使用しないこれらの関数の各バージョンはこのロケールに依存する動作に現在のロケールを使用します; _l のサフィックスのバージョンは同じですが、代わりに渡されたロケールパラメーターを使用します。詳細については、「ロケール」を参照してください。

汎用テキストルーチンのマップ

TCHAR.H のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tcspbrk	strpbrk	_mbspbrk	wcspbrk
適用なし	適用なし	_mbspbrk_l	適用なし

必要条件

ルーチン	必須ヘッダー
strpbrk	<string.h>
wcspbrk	<string.h> または <wchar.h>
_mbspbrk, _mbspbrk_l	<mbstring.h>

互換性の詳細については、「互換性」を参照してください。

使用例

// crt_strpbrk.c

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[100] = "The 3 men and 2 boys ate 5 pigs\n";
   char *result = NULL;

   // Return pointer to first digit in "string".
   printf( "1: %s\n", string );
   result = strpbrk( string, "0123456789" );
   printf( "2: %s\n", result++ );
   result = strpbrk( result, "0123456789" );
   printf( "3: %s\n", result++ );
   result = strpbrk( result, "0123456789" );
   printf( "4: %s\n", result );
}

同等の .NET Framework 関数

System::String::IndexOfAny

次の方法で共有

strpbrk、wcspbrk、_mbspbrk、_mbspbrk_l

パラメーター

戻り値

解説

必要条件

使用例

同等の .NET Framework 関数

参照

関連項目

その他のリソース