(PECL event >= 1.2.6-beta)
EventBuffer::search — Recherche dans le tampon une occurrence d'une chaîne
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.
what
Chaîne à chercher.
start
Position de départ de la recherche.
end
Position de fin de la recherche.
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.
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.
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"));
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
int(3)