Busca en el búfer una ocurrencia de un string

# EventBuffer::search

(PECL event >= 1.2.6-beta)

EventBuffer::search — Busca en el búfer una ocurrencia de un string

### Descripción

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

- EventBuffer::searchEol() - Busca en el búfer una ocurrencia de fin de línea

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open