EventBuffer::search
(PECL event >= 1.2.6-beta)
EventBuffer::search — Recherche dans le tampon une occurrence d'une chaîne
Description
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é 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.
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"));
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
int(3)
Voir aussi
- EventBuffer::searchEol() - Cherche dans le tampon une occurrence de fin de ligne