# 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