EventBuffer::pullup
(PECL event >= 1.2.6-beta)
EventBuffer::pullup — Linéarise les données du buffer et retourne le contenu du buffer sous la forme d'une chaîne
Description
$size
)
Linéarise les premiers size octets du buffer,
les copie ou les bouge comme nécessaire pour assurer qu'ils soient contigus
et le fait d'occuper la même partie de la mémoire. Si la taille
est négative, la fonction linéatise la totalité du buffer.
L'appel à la méthode EventBuffer::pullup() avec une taille très grande ralentie l'exécution, sachant qu'elle peut potentiellement avoir besoin de copier le contenu entier du buffer.
Liste de paramètres
-
size -
Le nombre d'octets qui doivent être contigus dans le buffer.
Valeurs de retour
Si size est supérieur au nombre d'octets du buffer,
la fonction retournera NULL. Sinon, EventBuffer::pullup()
retournera une chaîne de caractères.
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