(PECL event >= 1.2.6-beta)

EventBuffer::searchScans the buffer for an occurrence of a string


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

Scans the buffer for an occurrence of the string what . It returns numeric position of the string, or FALSE if the string was not found.

If the start argument is provided, it points to the position at which the search should begin; otherwise, the search is performed from the start of the string. If end argument provided, the search is performed between start and end buffer positions.



String to search.


Start search position.


End search position.

Valores devueltos

Returns numeric position of the first occurance of the string in the buffer, or FALSE if string is not found.


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 EventBuffer::search() example

// Count total occurances of 'str' in 'buf'
function count_instances($buf$str) {
$total 0;
$p     0;
$i     0;

    while (
1) {
$p $buf->search($str$p);
        if (
$p === FALSE) {


$buf = new EventBuffer();
$buf->add("Some string within a string inside another string");

El resultado del ejemplo sería algo similar a:


Ver también

add a note add a note

User Contributed Notes

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