Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

memcmp — comparaison de représentations en octets C23

`memcmp(s1, s2, n)` de `<string.h>` compare lexicographiquement les `n` premiers octets des représentations de deux objets, chaque octet étant interprété comme `unsigned char`. Le retour vaut zéro s’ils sont tous égaux ; sinon son signe est celui de la différence de la première paire distincte. Seul le signe, pas l’amplitude exacte, est garanti.

Version : C23

Syntaxe

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

memcmp(s1, s2, n) de <string.h> compare lexicographiquement les n premiers octets des représentations de deux objets, chaque octet étant interprété comme unsigned char. Le retour vaut zéro s’ils sont tous égaux ; sinon son signe est celui de la différence de la première paire distincte. Seul le signe, pas l’amplitude exacte, est garanti.

L’exemple compare 0x80 à 0x7F après l’octet commun 0x00. Les appels réels affichent 1 1 0 : le premier tampon est supérieur selon les octets non signés, un tampon est égal à lui-même et les préfixes communs d’un octet sont égaux.

La fonction compare des représentations, non des valeurs sémantiques : le padding d’une structure prend des valeurs non spécifiées après stockage, unions et octets inutilisés peuvent tromper, et des représentations distinctes peuvent désigner des valeurs égales. Pour une clé logique, compare les champs. n doit tenir dans les deux objets accessibles ; avec n == 0, le résultat vaut zéro, mais C23 exige encore deux valeurs de pointeur valides.

Exemples

#include <stdio.h>
#include <string.h>
int main(void){const unsigned char a[]={0x00,0x80,0xFF};const unsigned char b[]={0x00,0x7F,0xFF};printf("%d %d %d\n",memcmp(a,b,3)>0,memcmp(a,a,3)==0,memcmp(a,b,1));return 0;}

Résultat

1 1 0

L’exemple compare `0x80` à `0x7F` après l’octet commun `0x00`. Les appels réels affichent `1 1 0` : le premier tampon est supérieur selon les octets non signés, un tampon est égal à lui-même et les préfixes communs d’un octet sont égaux.

Sources