EventBuffer::search

(PECL event >= 1.2.6-beta)

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

Description

public 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'occurrence 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