(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 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.
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)