Copia um número especificado de bytes da frente do buffer

# EventBuffer::copyout

(PECL event >= 1.2.6-beta)

EventBuffer::copyout — Copia um número especificado de bytes da frente do buffer

### Descrição

public function EventBuffer::copyout( string `&$data` , int `$max_bytes` ): int

Comporta-se exatamente como EventBuffer::read() , mas não drena nenhum dado do buffer. Ou seja, ele copia os primeiros `max_bytes` bytes da frente do buffer para `data` . Se houver menos de `max_bytes` bytes disponíveis, a função copia todos os bytes que houver.

### Parâmetros

`data`

  String de saída.

`max_bytes`

  O número de bytes a serem copiados.

### Valor Retornado

Retorna o número de bytes copiados, ou `-1` em caso de falha.

### Veja Também

- EventBuffer::read() - Lê dados de um evbuffer e drena os bytes lidos
- EventBuffer::appendFrom() - Move o número especificado de bytes de um buffer de origem para o fim do buffer atual

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