# EventBuffer::pullup

(PECL event >= 1.2.6-beta)

EventBuffer::pullup — Linearizes data within buffer and returns it's contents as a string

### Descripción

public EventBuffer::pullup( int `$size` ): string

"Linearizes" the first `size` bytes of the buffer, copying or moving them as needed to ensure that they are all contiguous and occupying the same chunk of memory. If size is negative, the function linearizes the entire buffer.

Advertencia

Calling EventBuffer::pullup() with a large size can be quite slow, since it potentially needs to copy the entire buffer's contents.

### Parámetros

`size`

  The number of bytes required to be contiguous within the buffer.

### Valores devueltos

If `size` is greater than the number of bytes in the buffer, the function returns `null`. Otherwise, EventBuffer::pullup() returns string.

### Ver también

- EventBuffer::copyout() - Copia un número específico de bytes del principio del buffer
- EventBuffer::drain() - Elimina un número específico de bytes del principio del buffer sin copiarlo a ningún lugar
- EventBuffer::read() - Read data from an evbuffer and drain the bytes read
- EventBuffer::readLine() - Extracts a line from the front of the buffer
- EventBuffer::appendFrom() - Mueve el número de bytes especificados desde un buffer fuente, al final del buffer actual