(PECL event >= 1.2.6-beta)
EventBuffer::search — Verifica o buffer em busca de uma ocorrência de uma string
Verifica o buffer para uma ocorrência da string
what
. Ele retorna a posição numérica da string, ou false se a string não foi
encontrada.
Se o argumento
start
for fornecido, ele aponta para a posição na qual a pesquisa deve
começar; caso contrário, a pesquisa é realizada a partir do início da string. Se o argumento
end
for fornecido, a pesquisa é realizada entre as posições de buffer
inicial e final.
what
String para pesquisar.
start
Posição inicial de pesquisa.
end
Posição final de pesquisa.
Retorna a posição numérica da primeira ocorrência da string no
buffer, ou false se a string não for encontrada.
Esta função pode
retornar o valor booleano false, mas também pode retornar um valor não booleano que pode ser
avaliado como false. Leia a seção sobre Booleanos para mais
informações. Use o operador
=== para testar o valor retornado por esta
função.
Exemplo #1 Exemplo de EventBuffer::search()
<?php
// Conta o total de ocorrências de 'str' em '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("Uma string dentro de uma string dentro de outra string");
var_dump(count_instances($buf, "str"));
?>O exemplo acima produzirá algo semelhante a:
int(3)