EventBuffer::search

(PECL event >= 1.2.6-beta)

EventBuffer::search — Busca en el búfer una ocurrencia de un string

Descripción

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

Busca en el búfer una ocurrencia del string what. El método devuelve la posición numérica del string buscado, o false si el string no ha podido ser encontrado.

Si el argumento start es proporcionado, será la posición desde la cual la búsqueda debe comenzar; de lo contrario, la búsqueda se realizará desde el inicio del string. Si el argumento end es proporcionado, la búsqueda se realizará entre las posiciones de inicio y fin del búfer.

Parámetros

what

String a buscar.

start

Posición de inicio de la búsqueda.

end

Posición de fin de la búsqueda.

Valores devueltos

Devuelve la posición numérica de la primera ocurrencia del string en el búfer, o false si el string no ha sido encontrado.

Advertencia

Esta función puede retornar false, pero también puede retornar un valor equivalente a false. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de esta función.

Ejemplos

Ejemplo #1 Ejemplo con EventBuffer::search()

<?php
// Cuenta el número de ocurrencias del string 'str' en el búfer '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"));
?>

Resultado del ejemplo anterior es similar a:

int(3)

Ver también