STRCHR

Syntaxe

Paramètres

Description

Cette fonction effectue la recherche du premier caractère «c» dans la chaîne de caractères «str».

Remarques

• La fonction strchr() renvoie un pointeur sur la première occurrence de l'octet de poids faible de c dans la chaîne de caractères pointée par str. Si aucune correspondance n'est trouvée, un pointeur null est renvoyé.
• Recherche du caractère et retour d'un pointeur : strchr balaie la chaîne de caractères str de gauche à droite jusqu'à ce qu'elle trouve le premier c. Exemple :
1. char str[] = "Bonjour le monde!";
2. char* ptr = strchr(str, 'o');

Ici, ptr pointera vers la première occurrence de 'o', soit "onjour le monde!".

• Inclut le caractère nul ('\0') dans la recherche : strchr prend en compte le caractère nul ('\0') terminant une chaîne de caractères. Si on cherche '\0', la fonction retournera un pointeur sur la fin de la chaîne. Exemple :
1. char str[] = "Bonjour";
2. char* end = strchr(str, '\0');

Ici, end pointera juste après 'r', au '\0' terminal.

• Retourne nullptr si le caractère est absent : Si le caractère ch n'est pas trouvé, la fonction retourne nullptr. Exemple :
1. char str[] = "Bonjour";
2. char* result = strchr(str, 'z'); // 'z' n'est pas présent
3. if (result == nullptr) {
4.     std::cout << "Caractère non trouvé !" << std::endl;
5. }

Cela permet de savoir si une recherche a échoué.

• Peut être utilisée pour extraire une sous-chaîne : strchr est utile pour extraire une partie d'une chaîne à partir d'un caractère spécifique. Exemple :
1. char str[] = "name=jean";
2. char* value = strchr(str, '='); 
3. if (value) {
4.     value++; // Avancer pour pointer sur "jean"
5.     std::cout << "Valeur: " << value << std::endl;
6. }

Ici, on récupère "jean" après le =.

• Fonctionne sur les chaînes constantes (const char*) : strchr peut être utilisée sur une chaîne de caractères constante, mais retourne un const char* pour éviter une modification accidentelle. Exemple :
1. const char* str = "Bonjour";
2. const char* ptr = strchr(str, 'j'); // OK
3. *ptr = 'a'; // Erreur ! Modification interdite sur une constante

Cela empêche la modification involontaire d'une chaîne en lecture seulement.

• Comparaison avec strrchr (dernière occurrence) : Contrairement à strchr, cherchant la première occurrence, strrchr cherche la dernière. Exemple :
1. char str[] = "banana";
2. char* first = strchr(str, 'a');  // Trouve le 'a' de "banana"
3. char* last = strrchr(str, 'a');  // Trouve le dernier 'a'

strchr pointera vers "anana", tandis que strrchr pointera vers "a".

• Alternatives modernes avec std::string : En C++, il est préférable d'utiliser std::string::find, étant plus sûr et intuitif. Exemple :
1. #include <iostream>
2. #include <string>
3.  
4. int main() {
5.     std::string str = "Bonjour le monde!";
6.     size_t pos = str.find('o');
7.     if (pos != std::string::npos) {
8.         std::cout << "Caractère trouvé à la position " << pos << std::endl;
9.     }
10.     return 0;
11. }

Contrairement à strchr, std::string::find retourne un index et non un pointeur, ce qui évite certains bogues de gestion de mémoire.

Voir également

Langage de programmation - C++ - Référence de procédures et fonctions - strrchr
Langage de programmation - C - Référence de procédures et fonctions - strchr

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 734.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 252.