(PECL event >= 1.2.6-beta)
EventBuffer::search — Busca en el búfer una ocurrencia de un string
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.
what
String a buscar.
start
Posición de inicio de la búsqueda.
end
Posición de fin de la búsqueda.
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.
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.
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)