strpbrk、 wcspbrk、 _mbspbrk、 _mbspbrk_l

文字列をスキャンして、指定された文字セットの文字を検索します。

構文

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
使用するロケール。

戻り値

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

解説

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

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

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

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

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

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

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

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

要件

互換性の詳細については、「互換性」をご覧ください。

例

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

1: The 3 men and 2 boys ate 5 pigs

2: 3 men and 2 boys ate 5 pigs

3: 2 boys ate 5 pigs

4: 5 pigs

関連項目

文字列操作
ロケール
マルチバイト文字のシーケンスの解釈
strcspn、 wcscspn、 _mbscspn、 _mbscspn_l
strchr、 wcschr、 _mbschr、 _mbschr_l
strrchr、 wcsrchr、 _mbsrchr、 _mbsrchr_l