bionic (3) memcmp.3.gz

Provided by: manpages-ja-dev_0.5.0.0.20161015+dfsg-1_all bug

名前
       memcmp - メモリー領域を比較する


書式
       #include <string.h>

       int memcmp(const void *s1, const void *s2, size_t n);


説明
       memcmp()  関数は、メモリー領域 s1 とs2 の最初の n バイトを比較する (各バイトは unsigned char として解釈さ
       れる)。


返り値
       memcmp()  関数は、s1 の最初の n バイトが s2 の最初の n バイトよりも  小さいか、同じか、あるいは大きいかに
       よってそれぞれ、負の整数、0、 正の整数を返す。

       0  でない値の場合、 s1 と s2 で値が異なった最初のバイトの値の差で符号は決定される (バイトは unsigned char
       で解釈される)。

       n が 0 の場合、返り値は 0 となる。


属性
   マルチスレッディング (pthreads(7) 参照)
       memcmp() 関数はスレッドセーフである。


準拠
       SVr4, 4.3BSD, C89, C99, POSIX.1-2001.


注意
       暗号化された秘密などセキュリティ的に重要なデータの比較には memcmp() を使用しないこと。 必要な CPU  時間は
       値が等しいバイトの量に依存するからである。 その代わり、 一定時間で比較を実行する関数が必要である。 いくつ
       かのオペレーティングシステムでは (例えば NetBSD の consttime_memequal() などの)  関数が提供されているが、
       このような関数は POSIX では規定されていない。 Linux では、 このような関数自体を実装する必要があるかもしれ
       ない。


関連項目
       bcmp(3), strcasecmp(3), strcmp(3), strcoll(3), strncasecmp(3), strncmp(3), wmemcmp(3)


この文書について
       この man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクトの説明とバグ報告
       に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。

                                                   2014-12-31                                          MEMCMP(3)