PHP 8.5.0 Alpha 2 available for testing

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 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

add a note

User Contributed Notes

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