STRCASECMP(3) | FreeBSD Library Functions Manual | STRCASECMP(3) |
名称
strcasecmp, strncasecmp — 大文字小文字を無視して文字列を比較するライブラリ
Standard C Library (libc, -lc)書式
#include < strings.h> int
strcasecmp( const char *s1, const char *s2);
int
strncasecmp( const char *s1, const char *s2, size_t len);
#include < string.h>
#include < xlocale.h>
int
strcasecmp_l( const char *s1, const char *s2, locale_t loc);
int
strncasecmp_l( const char *s1, const char *s2, site_t len, locale_t loc);
解説
strcasecmp() と strncasecmp() 関数は、ヌル文字で終了する文字列 s1 と s2 を比較します。strncasecmp() 関数は、多くても len 文字を比較します。 strcasecmp_l() と strncasecmp_l() 関数は、上記のロケールを考慮しないバージョンと同じことを行いますが、現在のロケールを使用するのではなく明示的なロケールを試みます。
戻り値
関数 strcasecmp() と strncasecmp() は、個々の対応する文字を小文字に変換した後に、 s1 が、辞書編集順に s2 より、大きいか、等しいか、または未満かどうかに応じて 0 より大きい、等しい、または未満の整数を返します。文字列自体は、修正されません。比較は、‘\200
’が‘
\0
’より大きくなるように、符号無し文字 (unsigned char) を使用して行われます。関数
strcasecmp_l() と
strncasecmp_l() は、同じことを行いますが、明示的なロケールを試みます。
歴史
strcasecmp() と strncasecmp() 関数は、 4.4BSD ではじめて登場しました。それらのプロトタイプは、 IEEE Std 1003.1-2001 (“POSIX.1”) 準拠のために < strings.h> に移動される前は、これまで < string.h> に存在しました。June 9, 1993 | FreeBSD |