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

public string EventBuffer::pullup ( int $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.

Avertissement

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