# str_contains

(PHP 8)

str_contains — Détermine si une chaîne contient une sous-chaîne donnée

### Description

str_contains(string `$haystack`, string `$needle`): bool

Effectue une vérification sensible à la casse indiquant si `needle` est contenue dans `haystack`.

### Liste de paramètres

`haystack`

  La chaîne dans laquelle on effectue la recherche.

`needle`

  La sous-chaîne à rechercher dans `haystack`.

### Valeurs de retour

Renvoie `true` si `needle` est dans `haystack`, sinon `false`.

### Exemples

Exemple #1 Avec une chaîne vide `''`

`<?php
if (str_contains('abc', '')) {
echo "Checking the existence of the empty string will always return true";
}
?>`

L'exemple ci-dessus va afficher :

    Checking the existence of the empty string will always return true

Exemple #2 Démonstration de la sensibilité à la casse

`<?php
$string = 'The lazy fox jumped over the fence';
if (str_contains($string, 'lazy')) {
echo "The string 'lazy' was found in the string\n";
}
if (str_contains($string, 'Lazy')) {
echo 'The string "Lazy" was found in the string';
} else {
echo '"Lazy" was not found because the case does not match';
}
?>`

L'exemple ci-dessus va afficher :

    The string 'lazy' was found in the string
    "Lazy" was not found because the case does not match

### Notes

> Note: Cette fonction gère les chaînes binaires.

### Voir aussi

- str_ends_with() - Détermine si une chaîne se termine par une sous-chaîne donnée
- str_starts_with() - Détermine si une chaîne commence par une sous-chaîne donnée
- stripos() - Recherche la position de la première occurrence dans une chaîne, sans tenir compte de la casse
- strrpos() - Cherche la position de la dernière occurrence d'une sous-chaîne dans une chaîne
- strripos() - Cherche la position de la dernière occurrence d'une chaîne contenue dans une autre, de façon insensible à la casse
- strstr() - Trouve la première occurrence dans une chaîne
- strpbrk() - Recherche un ensemble de caractères dans une chaîne de caractères
- substr() - Retourne un segment de chaîne
- preg_match() - Effectue une recherche de correspondance avec une expression rationnelle standard