Scroll to navigation

memcmp(3) Library Functions Manual memcmp(3)

NAZWA

memcmp - porównuje pamięć

BIBLIOTEKA

Standardowa biblioteka C (libc, -lc)

SKŁADNIA

#include <string.h>  // zob. memory.h(3head)
int memcmp(size_t n;
           const void s1[n], const void s2[n], size_t n);

OPIS

Funkcja memcmp() porównuje pierwsze n bajtów (każdy interpretowany jako unsigned char) obszaru pamięci s1 z obszarem s2.

WARTOŚĆ ZWRACANA

Funkcja memcmp() zwraca liczbę całkowitą mniejszą od zera, równą zeru lub większą od zera, jeżeli s1 jest odpowiednio mniejszy niż, równy lub większy niż pierwsze n bajtów s2.

Jeśli wartość zwracana jest niezerowa, dodatni lub ujemny znak tej wartości jest określany na podstawie znaku różnicy pomiędzy pierwszą parę bajtów (interpretowanych jako unsigned char), które się różnią pomiędzy s1 i s2.

Jeśli n jest zerem, zwracaną wartością jest zero.

ATRYBUTY

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

Interfejs Atrybut Wartość
memcmp() Bezpieczeństwo wątkowe MT-bezpieczne

WERSJE

POSIX.1 określa jedynie, że:

Znak niezerowej wartości zwracanej określa się na podstawie znaku różnicy pomiędzy wartościami pierwszej pary bajtów (interpretowanych jako typu unsigned char) różniącej się w porównywanych łańcuchach.

W glibc, podobnie jak w większości innych implementacji, wartość zwracana jest arytmetycznym wynikiem odjęcia ostatniego porównywanego bajtu w s2, od ostatniego porównywanego bajtu w s1 (jeśli te dwa znaki są sobie równe, różnica wynosi 0).

STANDARDY

C11, POSIX.1-2008.

HISTORIA

POSIX.1-2001, C89, SVr4, 4.3BSD.

ZASTRZEŻENIA

Nie należy używać memcmp() do porównywania danych poufnych, takich jak sekrety kryptograficzne, ponieważ czas procesora wymagany do porównywania zależy od zawartości porównywanych adresów, co czyni tę funkcję podatną na ataki bocznego kanału bazujące na czasie. W takich przypadkach, wymagana jest funkcja wykonująca porównanie w deterministycznym czasie, zależnym tylko od n (liczby porównywanych bajtów). Niektóre systemy operacyjne udostępniają taką funkcję (np. w systemie NetBSD jest to consttime_memequal()), lecz nie określono jej w specyfikacji POSIX. W Linuksie, może być konieczne samodzielne zaimplementowanie takiej funkcji.

ZOBACZ TAKŻE

memory.h(3head), memeq(3), wmemcmp(3)

TŁUMACZENIE

Tłumaczenie niniejszej strony podręcznika: Adam Byrtek <alpha@irc.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.

10 sierpnia 2026 r. Linux man-pages 6.20