EventBuffer::search

(PECL event >= 1.2.6-beta)

EventBuffer::search — Verifica o buffer em busca de uma ocorrência de uma string

Descrição

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

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.

Parâmetros

what: String para pesquisar.
start: Posição inicial de pesquisa.
end: Posição final de pesquisa.

Valor Retornado

Retorna a posição numérica da primeira ocorrência da string no buffer, ou false se a string não for encontrada.

Aviso

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.

Exemplos

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)

Veja Também

EventBuffer::searchEol() - Verifica o buffer para detectar a ocorrência de um fim de linha