Recherche dans le tampon une occurrence d'une chaîne

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

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