.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH strcmp 3 "28 juin 2025" "Pages du manuel de Linux 6.15" 
.SH NOM
strcmp, strncmp \- Comparer deux chaînes
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP,\ \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#include <string.h>\fP
.P
\fBint strcmp(const char *\fP\fIs1\fP\fB, const char *\fP\fIs2\fP\fB);\fP
\fBint strncmp(\fPsize_t n;
\fB            const char \fP\fIs1\fP\fB[\fP\fIn\fP\fB], const char \fP\fIs2\fP\fB[\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB);\fP
.fi
.SH DESCRIPTION
La fonction \fBstrcmp\fP() compare les deux chaînes \fIs1\fP et \fIs2\fP. La locale
n'est pas prise en compte (pour une comparaison basée sur la locale,
consultez \fBstrcoll\fP(3)). La comparaison est effectuée sur des caractères
non signés.
.P
\fBstrcmp\fP() retourne un entier indiquant le résultat de la comparaison comme
suit :
.IP \- 3
\fB0\fP si \fIs1\fP et \fIs2\fP sont égales ;
.IP \-
une valeur négative si \fIs1\fP est inférieure à \fIs2\fP ;
.IP \-
une valeur positive si \fIs1\fP est supérieure à \fIs2\fP.
.P
La fonction \fBstrncmp\fP() est similaire, mais elle ne compare (au plus) que
les \fIn\fP premiers octets de \fIs1\fP et \fIs2\fP.
.SH "VALEUR RENVOYÉE"
Les fonctions \fBstrcmp\fP() et \fBstrncmp\fP() renvoient un entier inférieur,
égal ou supérieur à zéro si \fIs1\fP (ou ses \fIn\fP premiers octets) est
respectivement inférieure, égale ou supérieure à \fIs2\fP.
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
.na
.nh
\fBstrcmp\fP(),
\fBstrncmp\fP()
T}	Sécurité des threads	MT\-Safe
.TE
.SH VERSIONS
POSIX.1 ne spécifie uniquement que :
.RS
.P
Le signe d'une valeur non nulle renvoyée doit être déterminé par le signe de
la différence entre les valeurs de la première paire d'octets (interprétées
comme des \fIunsigned char\fP) qui différent dans les chaînes comparées.
.RE
.P
Dans la glibc, et comme dans la plupart des implémentations, la valeur
retournée est le résultat arithmétique de la soustraction du dernier octet
comparé de \fIs2\fP au dernier octet comparé dans \fIs1\fP (si les deux caractères
sont identiques, la différence est \fB0\fP).
.SH STANDARDS
C11, POSIX.1\-2008.
.SH HISTORIQUE
POSIX.1\-2001, C89, SVr4, 4.3BSD.
.SH EXEMPLES
Le programme suivant peut être utilisé pour illustrer le fonctionnement de
\fBstrcmp\fP() (recevant deux arguments) et \fBstrncmp\fP() (recevant trois
arguments). Tout d'abord, quelques exemples utilisant \fBstrcmp\fP() :
.P
.in +4n
.EX
$\fB ./string_comp ABC ABC\fP;
<str1> and <str2> are equal
$\fB ./string_comp ABC AB\fP;      # \[aq]C\[aq] is ASCII 67; \[aq]C\[aq] \- \[aq]\[rs]0\[aq] = 67
<str1> is greater than <str2> (67)
$\fB ./string_comp ABA ABZ\fP;     # \[aq]A\[aq] is ASCII 65; \[aq]Z\[aq] is ASCII 90
<str1> is less than <str2> (\-25)
$\fB ./string_comp ABJ ABC\fP;
<str1> is greater than <str2> (7)
$\fB ./string_comp $\[aq]\[rs]201\[aq] A\fP;   # 0201 \- 0101 = 0100 (or 64 decimal)
<str1> is greater than <str2> (64)
.EE
.in
.P
Le dernier exemple utilise une syntaxe spécifique à \fBbash\fP(1) pour générer
un chaîne de caractères contenant un code ASCII 8 bits ; le resultat met en
évidence que la comparaison des chaînes travaille sur des caractères non
signés.
.P
Et quelques exemples utilisant \fBstrncmp\fP() :
.P
.in +4n
.EX
$\fB ./string_comp ABC AB 3\fP;
<str1> is greater than <str2> (67)
$\fB ./string_comp ABC AB 2\fP;
<str1> and <str2> are equal in the first 2 bytes
.EE
.in
.SS "Source du programme"
.\" SRC BEGIN (string_comp.c)
\&
.EX
/* string_comp.c
\&
   Sous licence GNU General Public v2 ou postérieure.
*/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
\&
int
main(int argc, char *argv[])
{
    int res;
\&
    if (argc < 3) {
        fprintf(stderr, "Utilisation : %s <str1> <str2> [<n>]\[rs]n", argv[0]);
        exit(EXIT_FAILURE);
    }
\&
    if (argc == 3)
        res = strcmp(argv[1], argv[2]);
    else
        res = strncmp(argv[1], argv[2], atoi(argv[3]));
\&
    if (res == 0) {
        printf("<str1> et <str2> sont égaux");
        if (argc > 3)
            printf(" pour les %d premiers octets\[rs]n", atoi(argv[3]));
        printf("\[rs]n");
    } else if (res < 0) {
        printf("<str1> est inférieure à <str2> (%d)\[rs]n", res);
    } else {
        printf("<str1> est supérieure à <str2> (%d)\[rs]n", res);
    }
\&
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "VOIR AUSSI"
\fBmemcmp\fP(3), \fBstrcasecmp\fP(3), \fBstrcoll\fP(3), \fBstring\fP(3),
\fBstrncasecmp\fP(3), \fBstrverscmp\fP(3), \fBwcscmp\fP(3), \fBwcsncmp\fP(3),
\fBascii\fP(7)
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess <https://www.blaess.fr/christophe/>,
Stéphan Rafin <stephan.rafin@laposte.net>,
Thierry Vignaud <tvignaud@mandriva.com>,
François Micaux,
Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>,
Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>,
Julien Cristau <jcristau@debian.org>,
Thomas Huriaux <thomas.huriaux@gmail.com>,
Nicolas François <nicolas.francois@centraliens.net>,
Florentin Duneau <fduneau@gmail.com>,
Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
Denis Barbier <barbier@debian.org>,
David Prévot <david@tilapin.org>,
Frédéric Hantrais <fhantrais@gmail.com>,
Grégoire Scano <gregoire.scano@malloc.fr>
et
Lucien Gentis <lucien.gentis@waika9.com>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .