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 が返されます。 little が big のどこにも現れないなら、 NULL が返されます。そうでなければ、最初に出現した little の最初の文字へのポインタが返されます。使用例
次は、 largestring の“Bar Baz
”部分にポインタ
ptr を設定します。
const char *largestring = "Foo Bar Baz"; const char *smallstring = "Bar"; char *ptr; ptr = strstr(largestring, smallstring);
次は、ポインタ ptr を NULL に設定します、なぜなら largestring の最初の 4 文字だけが検索されるためです:
const char *largestring = "Foo Bar Baz"; const char *smallstring = "Bar"; char *ptr; ptr = strnstr(largestring, smallstring, 4);
関連項目
memchr(3), memmem(3), strchr(3), strcspn(3), strpbrk(3), strrchr(3), strsep(3), strspn(3), strtok(3), wcsstr(3)規格
strstr() 関数は、 ISO/IEC 9899:1990 (“ISO C90”) に適合しています。October 11, 2001 | FreeBSD |