EN JA
STRSTR(3)
STRSTR(3) FreeBSD Library Functions Manual STRSTR(3)

名称

strstr, strcasestr, strnstr文字列中の部分文字列に位置付けする

ライブラリ

Standard C Library (libc, -lc)

書式

#include < string.h>

char *
strstr( const char *big, const char *little);

char *
strcasestr( const char *big, const char *little);

char *
strnstr( const char *big, const char *little, size_t len);

#include < string.h>
#include < xlocale.h>

char *
strcasestr_l( const char *big, const char *little, locale_t loc);

解説

strstr() 関数は、ヌル文字で終了する文字列 big 中に最初に出現するヌル文字で終了する文字列 little に位置付けます。

strcasestr() 関数は、 strstr() と同様ですが、両方の文字列の大文字と小文字を無視します。

strcasestr_l() 関数は、 strcasestr() と同じこと行いますが、現在のロケールを使用するのではなく明示的なロケールを試みます。

strnstr() 関数は、文字列 big 中に最初に出現するヌル文字で終了する文字列 little に位置付けます、ここで、 len 文字を越える文字は、検索されません。‘ \0’文字の後に現れる文字は、検索されません。 strnstr() 関数は、 FreeBSD 特有の API であるので、移植性に関係がないときのみ利用されるべきです。

戻り値

little が空の文字列であるなら、 big が返されます。 littlebig のどこにも現れないなら、 NULL が返されます。そうでなければ、最初に出現した little の最初の文字へのポインタが返されます。

使用例

次は、 largestring の“ Bar Baz”部分にポインタ ptr を設定します。

const char *largestring = "Foo Bar Baz"; 
const char *smallstring = "Bar"; 
char *ptr; 
 
ptr = strstr(largestring, smallstring);

次は、ポインタ ptrNULL に設定します、なぜなら largestring の最初の 4 文字だけが検索されるためです:

const char *largestring = "Foo Bar Baz"; 
const char *smallstring = "Bar"; 
char *ptr; 
 
ptr = strnstr(largestring, smallstring, 4);

規格

strstr() 関数は、 ISO/IEC 9899:1990 (“ISO C90”) に適合しています。
October 11, 2001 FreeBSD