EN JA
STRCASECMP(3)
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() 関数は、ヌル文字で終了する文字列 s1s2 を比較します。

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