.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\" and Copyright 2020 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 18:08:52 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified 2001-08-31, aeb
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH strcmp 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" 
.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
.PP
\fBint strcmp(const char *\fP\fIs1\fP\fB, const char *\fP\fIs2\fP\fB);\fP
\fBint strncmp(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.
.PP
\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.
.PP
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
.sp 1
.SH VERSIONS
POSIX.1 ne spécifie uniquement que\ :
.RS
.PP
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
.PP
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()\ :
.PP
.in +4n
.EX
$ \fB./string_comp ABC ABC\fP
<str1> et <str2> sont égales
$ \fB./string_comp ABC AB\fP      # le code ASCII de  \[aq]C\[aq] est 67;  \[aq]C\[aq] \- \[aq]\e0\[aq] = 67
<str1> est supérieure à <str2> (67)
$ \fB./string_comp ABA ABZ\fP     # le code ASCII de \[aq]A\[aq] est 65; le code ASCII de \[aq]Z\[aq] est 90
<str1> est inférieure à <str2> (\-25)
$ \fB./string_comp ABJ ABC\fP
<str1> est supérieure à <str2> (7)
$ .\fB/string_comp $\[aq]\e201\[aq]\fP   # 0201 \- 0101 = 0100 (ou 64 en décimal)
<str1> est supérieure à <str2> (64)
.EE
.in
.PP
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.
.PP
Et quelques exemples utilisant \fBstrncmp\fP()\ :
.PP
.in +4n
.EX
$ \fB./string_comp ABC AB 3\fP
<str1> est supérieure à <str2> (67)
$ \fB./string_comp ABC AB 2\fP
<str1> et <str2> ont leurs deux premiers octets égaux
.EE
.in
.SS "Source du programme"
.\" SRC BEGIN (string_comp.c)
\&
.EX
/* string_comp.c
\&
   Licensed under GNU General Public License v2 or later.
*/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
\&
int
main(int argc, char *argv[])
{
    int res;
\&
    if (argc < 3) {
        fprintf(stderr, "Usage: %s <str1> <str2> [<len>]\en", 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> and <str2> are equal");
        if (argc > 3)
            printf(" in the first %d bytes\en", atoi(argv[3]));
        printf("\en");
    } else if (res < 0) {
        printf("<str1> is less than <str2> (%d)\en", res);
    } else {
        printf("<str1> is greater than <str2> (%d)\en", 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 .