NOM

       strverscmp - Comparer deux chaînes versionnées

SYNOPSIS

       #define _GNU_SOURCE         /* Consultez feature_test_macros(7) */
       #include <string.h>

       int strverscmp(const char *s1, const char *s2);

DESCRIPTION

       On  a  souvent des fichiers jan1, jan2, ..., jan9, jan10, ... et il est malvenu que ls(1) les classe dans
       l'ordre jan1, jan10, ..., jan2, ..., jan9. Afin de remédier à cela, GNU a introduit l'option -v à  ls(1),
       option implémentée en utilisant versionsort(3), qui utilise lui-même strverscmp().

       Ainsi,  la tâche de strverscmp() consiste à comparer deux chaînes et à déterminer le « bon » ordre, alors
       que strcmp(3) détermine seulement l'ordre lexicographique. Cette fonction n'utilise pas la  catégorie  de
       localisation  LC_COLLATE,  elle  vise donc principalement les situations dans lesquelles les chaînes sont
       supposées être en ASCII.

       Cette fonction travaille comme suit : si les deux chaînes  sont  égales,  elle  renvoie  0.  Sinon,  elle
       recherche  une  position  entre  deux octets ayant la propriété suivante : avant cette position, les deux
       chaînes sont égales, alors qu'immédiatement après, elles diffèrent. Elle détermine alors les plus longues
       chaînes  de chiffres consécutifs contenant (ou commençant ou se finissant à) cette position. Si l'une des
       chaînes ou bien les deux chaînes  sont  vides,  alors  elle  renvoie  ce  que  strcmp(3)  aurait  renvoyé
       (classement  numérique  des  valeurs  d'octets).  Sinon,  elle  compare numériquement les deux chaînes de
       chiffres, où les chaînes de chiffres commençant par un ou plusieurs  zéros  sont  interprétées  comme  si
       elles  avaient  un  séparateur  décimal  en en-tête (de telle sorte que notamment les chaînes de chiffres
       commençant par davantage de zéros viennent avant les chaînes de chiffres avec moins de zéros en en-tête).
       Ainsi, le classement est 000, 00, 01, 010, 09, 0, 1, 9, 10.

VALEUR RENVOYÉE

       La fonction strverscmp() renvoie un entier inférieur, égal ou supérieur à zéro si s1 est déterminée comme
       étant respectivement plus récente, égale à ou postérieure à s2.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌─────────────┬──────────────────────┬─────────┐
       │Interface    │ Attribut             │ Valeur  │
       ├─────────────┼──────────────────────┼─────────┤
       │strverscmp() │ Sécurité des threads │ MT-Safe │
       └─────────────┴──────────────────────┴─────────┘

CONFORMITÉ

       Cette fonction est une extension GNU.

EXEMPLES

       Le programme suivant présente le fonctionnement de strverscmp(). Il utilise  strverscmp()  pour  comparer
       deux chaînes de caractères fournies sur la ligne de commande. Voici un exemple de son utilisation :

           $ ./a.out jan1 jan10
           jan1 < jan10

   Source du programme

       #define _GNU_SOURCE
       #include <string.h>
       #include <stdio.h>
       #include <stdlib.h>

       int
       main(int argc, char *argv[])
       {
           int res;

           if (argc != 3) {
               fprintf(stderr, "Usage : %s <string1> <string2>\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           res = strverscmp(argv[1], argv[2]);

           printf("%s %s %s\n", argv[1],
                   (res < 0) ? "<" : (res == 0) ? "==" : ">", argv[2]);

           exit(EXIT_SUCCESS);
       }

VOIR AUSSI

       rename(1), strcasecmp(3), strcmp(3), strcoll(3)

COLOPHON

       Cette page fait partie de la publication 5.10 du projet man-pages Linux. Une description du projet et des
       instructions pour signaler des anomalies et la dernière version de cette page  peuvent  être  trouvées  à
       l'adresse https://www.kernel.org/doc/man-pages/.

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>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  concernant  les  conditions  de   copie   et   de
       distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si  vous  découvrez  un  bogue  dans la traduction de cette page de manuel, veuillez envoyer un message à
       debian-l10n-french@lists.debian.org ⟨⟩.