La classe EventBuffer

(PECL event >= 1.5.0)

Introduction

La classe EventBuffer représente "evbuffer" de Libevent, un utilitaire pour les I/O bufferisés.

Les buffers d'événements sont générallement utiles pour réaliser la partie buffer d'un réseau I/O bufferisé.

Synopsis de la classe

EventBuffer {

/* Constants */

const integer EOL_ANY = 0 ;

const integer EOL_CRLF = 1 ;

const integer EOL_CRLF_STRICT = 2 ;

const integer EOL_LF = 3 ;

const integer PTR_SET = 0 ;

const integer PTR_ADD = 1 ;

/* Propriétés */

public readonly int $length ;

public readonly int $contiguous_space ;

/* Méthodes */

public bool add ( string $data )

public bool addBuffer ( EventBuffer $buf )

public int appendFrom ( EventBuffer $buf , int $len )

public __construct ( void )

public int copyout ( string &$data , int $max_bytes )

public bool drain ( int $len )

public void enableLocking ( void )

public bool expand ( int $len )

public bool freeze ( bool $at_front )

public void lock ( void )

public bool prepend ( string $data )

public bool prependBuffer ( EventBuffer $buf )

public string pullup ( int $size )

public string read ( int $max_bytes )

public int read ( mixed $fd , int $howmuch )

public string readLine ( int $eol_style )

public mixed search ( string $what [, int $start = -1 [, int $end = -1 ]] )

public mixed searchEol ([ int $start = -1 [, int $eol_style = EventBuffer::EOL_ANY ]] )

public string substr ( int $start [, int $length ] )

public bool unfreeze ( bool $at_front )

public bool unlock ( void )

public int write ( mixed $fd [, int $howmuch ] )

}

Propriétés

length: Le nombre d'octets stockés dans un buffer d'événement.
contiguous_space: Le nombre d'octets stockés de façon contigues au début du buffer. Les octets dans un buffer peuvent être stockés dans plusieurs parties séparées de la mémoire ; cette propriété retourne le nombre d'octets actuellement stockés dans la première partie.

Constantes pré-définies

EventBuffer::EOL_ANY: La fin de ligne est une séquence de nombre représentent un retour charriot et une nouvelle ligne. Ce format n'est pas très utile ; il existe encore seulement pour des raisons de compatibilité ascendante.
EventBuffer::EOL_CRLF: La fin de ligne est un retour charriot optionnel, suivi par une nouvelle ligne. (En d'autres termes, c'est soit "\r\n", soit "\n"). Ce format est utile pour analyser les protocoles Internet basés sur du texte ; le standard veut qu'on utilise "\r\n" mais quelques clients fournissent seulement "\n".
EventBuffer::EOL_CRLF_STRICT: La fin de ligne est un simple retour charriot, suivant par une simple nouvelle ligne (aussi connu comme "\r\n". Les valeurs ASCII sont 0x0D 0x0A).
EventBuffer::EOL_LF: La fin de ligne est un simple caractère de nouvelle ligne (aussi connu comme "\n". La valeur ASCII est 0x0A).
EventBuffer::PTR_SET: Drapeau utilisé comme argument de la méthode EventBuffer::setPosition(). Si ce drapeau est spécifié, la position du pointeur est déplacé à une position absolue du buffer.
EventBuffer::PTR_ADD: Identique à EventBuffer::PTR_SET, sauf que ce drapeau fait que la méthode EventBuffer::setPosition() se déplace à une position en arrière par rapport au numéro d'octers spécifié (au lieu de définir une position absolue).

Sommaire

EventBuffer::add — Ajoute des données à la fin du tampon d'événement
EventBuffer::addBuffer — Déplace toutes les données du tampon fourni dans l'instance courante EventBuffer
EventBuffer::appendFrom — Déplace le nombre d'octets fourni depuis un tampon source vers la fin du tampon courant
EventBuffer::__construct — Construit un objet EventBuffer
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::enableLocking — Description
EventBuffer::expand — Réserve de l'espace dans le tampon
EventBuffer::freeze — Permet d'empécher les appels qui tentent de modifier un tampon d'événements de réussir
EventBuffer::lock — Acquière un verrou sur le buffer
EventBuffer::prepend — Ajoute des données au début du buffer
EventBuffer::prependBuffer — Déplace toutes les données depuis le buffer source vers le début du buffer courant
EventBuffer::pullup — Linéarise les données du buffer et retourne le contenu du buffer sous la forme d'une chaîne
EventBuffer::read — Lit les données d'un evbuffer, et vide les octets lus
EventBuffer::readFrom — Lit des données depuis un fichier et les place à la fin du tampon
EventBuffer::readLine — Extrait une ligne depuis le début du tampon
EventBuffer::search — Recherche dans le tampon une occurrence d'une chaîne
EventBuffer::searchEol — Cherche dans le tampon une occurrence de fin de ligne
EventBuffer::substr — Soustrait une portion des données du tampon
EventBuffer::unfreeze — Ré-active les appels qui permettent de modifier un buffer d'événements
EventBuffer::unlock — Libère un verrou acquis avec EventBuffer::lock
EventBuffer::write — Ecrit le contenu du buffer dans un fichier ou dans un socket