EventBuffer::pullup
(PECL event >= 1.2.6-beta)
EventBuffer::pullup — Linearizes data within buffer and returns it's contents as a string
Description
public
void
EventBuffer::pullup
(
string
$size
)
"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.
Avertissement
Calling EventBuffer::pullup() with a large size can be quite slow, since it potentially needs to copy the entire buffer's contents.
Liste de paramètres
-
size
-
The number of bytes required to be contiguous within the buffer.
Valeurs de retour
If
size
is greater than the number of bytes in the buffer, the function returns
NULL
. Otherwise,
EventBuffer::pullup()
returns string.
Voir aussi
- EventBuffer::copyout() - Copie le nombre d'octets spécifié depuis le début du tampon
- EventBuffer::drain() - Supprime un nombre spécifié d'octets depuis le début du tampon sans copier les données
- EventBuffer::read() - Lit les données d'un evbuffer, et vide les octets lus
- EventBuffer::readLine() - Extrait une ligne depuis le début du tampon
- EventBuffer::appendFrom() - Déplace le nombre d'octets fourni depuis un tampon source vers la fin du tampon courant