Recherche dans le tampon une occurrence d'une chaîne

# EventBuffer::search

(PECL event >= 1.2.6-beta)

EventBuffer::search — Recherche dans le tampon une occurrence d'une chaîne

### Description

public function EventBuffer::search( string `$what` , int `$start` = -1 , int `$end` = -1 ): mixed

Recherche dans le tampon une occurrence de la chaîne `what`. La méthode retourne la position numérique de la chaîne recherchée, ou `false` si la chaîne n'a pu être trouvée.

Si l'argument `start` est fourni, ce sera la position à partir de laquelle la recherche doit commencer ; sinon, la recherche sera réalisée depuis le début de la chaîne. Si l'argument `end` est fourni, la recherche sera réalisée entre les positions de début et de fin du tampon.

### Liste de paramètres

`what`

  Chaîne à chercher.

`start`

  Position de départ de la recherche.

`end`

  Position de fin de la recherche.

### Valeurs de retour

Retourne la position numérique de la première occurrence de la chaîne dans le tampon, ou `false` si la chaîne n'a pas été trouvée.

Avertissement

Cette fonction peut retourner `false`, mais elle peut aussi retourner une valeur équivalent à `false`. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

### Exemples

Exemple #1 Exemple avec EventBuffer::search()

    <?php
    // Compte le nombre d'occurrences de la chaîne 'str' dans le tampon 'buf'
    function count_instances($buf, $str) {
        $total = 0;
        $p     = 0;
        $i     = 0;

        while (1) {
            $p = $buf->search($str, $p);
            if ($p === FALSE) {
                break;
            }
            ++$total;
            ++$p;
        }

        return $total;
    }

    $buf = new EventBuffer();
    $buf->add("Some string within a string inside another string");
    var_dump(count_instances($buf, "str"));
    ?>

Résultat de l'exemple ci-dessus est similaire à :

    int(3)

### Voir aussi

- EventBuffer::searchEol() - Cherche dans le tampon une occurrence de fin de ligne

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open