wcschr() — ワイド文字の検索

フォーマット

#include <wchar.h>
wchar_t *wcschr(const wchar_t *string, wchar_t character);

言語レベル

XPG4

スレッド・セーフ

はい

ワイド文字関数

詳細については、ワイド文字を参照してください。

説明

wcschr() 関数は、ワイド文字 string 内の character のオカレンスを 検索します。character は、wchar_t ヌル文字 (¥0) にすることができます。 string の終わりにある wchar_t ヌル文字は 検索に含まれます。

wcschr() 関数は、ヌル終了 wchar_t ストリング上で作動します。 この関数のストリング引数には、ストリングの終わりを示す wchar_t ヌル文字 が入っていなければなりません。

戻り値

wcschr() 関数は、string 内の character が最初に現れる位置へのポインターを戻します。文字が検出されない場合は、NULL ポインターが戻されます。

この例では、ワイド文字ストリング "computer program" 内の文字 "p" の最初の出現を検出します。
#include <stdio.h>
#include <wchar.h>
 
#define SIZE 40
 
int main(void)
{
  wchar_t buffer1[SIZE] = L"computer program";
  wchar_t * ptr;
  wchar_t ch = L'p';
 
  ptr = wcschr( buffer1, ch );
  printf( "The first occurrence of %lc in '%ls' is '%ls'¥n",
                          ch, buffer1, ptr );
 
}
 
/****************  Output should be similar to: ******************
 
The first occurrence of p in 'computer program' is 'puter program'
*/