strcasecmp ()- Comparer les chaînes sans sensibilité à la casse

Format

#include <strings.h>
int strcasecmp(const char *string1, const char *string2);

Niveau de langue

XPG4

Unités d'exécution protégées

Oui

Sensible à l'environnement local

Le comportement de cette fonction peut être affecté par la catégorie LC_CTYPE de l'environnement local en cours. Cette fonction n'est pas disponible lorsque LOCALETYPE (*CLD) est indiqué dans la commande de compilation. Pour plus d'informations, voir Présentation des CCSID et des environnements locaux.

Description

La fonction strcasecmp() compare string1 et string2 sans tenir compte de la casse. Tous les caractères alphabétiques dans string1 et string2 sont convertis en minuscules avant la comparaison.

La fonction strcasecmp() fonctionne sur des chaînes à terminaison nulle. Les arguments de chaîne de la fonction doivent contenir un caractère null ('\0') marquant la fin de la chaîne.

Valeur renvoyée

La fonction strcasecmp() renvoie une valeur indiquant la relation entre les deux chaînes, comme suit:

Tableau 1. Valeurs de retour de `strcasecmp()`
Valeur	Signification
Inférieur à 0	string1 inférieur à string2
0	string1 équivalent à string2
Supérieur à 0	string1 supérieure à string2

Exemple

Cet exemple utilise strcasecmp() pour comparer deux chaînes.

#include <stdio.h>
#include <strings.h>

int main(void)
{
  char_t *str1 = "STRING";
  char_t *str2 = "string";
  int result;

  result = strcasecmp(str1, str2);

  if (result == 0)
    printf("Strings compared equal.\n");
  else if (result < 0)
    printf("\"%s\" is less than \"%s\".\n", str1, str2);
  else
    printf("\"%s\" is greater than \"%s\".\n", str1, str2);

  return 0;
}

/********  The output should be similar to: ***************

Strings compared equal.

***********************************/