EventBuffer::search

(PECL event >= 1.2.6-beta)

EventBuffer::searchBusca en el búfer una ocurrencia de un string

Descripción

public 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 devolver el valor booleano false, pero también puede devolver un valor no booleano que se evalúa como false. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por 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"));
?>

El resultado del ejemplo sería algo similar a:

int(3)

Ver también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top