EventBuffer::search

(PECL event >= 1.2.6-beta)

EventBuffer::searchRecherche dans le tampon une occurrence d'une chaîne

Description

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

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.

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"));
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

int(3)

Voir aussi

LoadingChargement en cours