La classe EventBuffer

Table des matières

(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é.

Retour à la première page de Manuel PHP Table des matières Haut

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 add ( string $data ) : bool

public addBuffer ( EventBuffer $buf ) : bool

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

public __construct ( void )

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

public drain ( int $len ) : bool

public enableLocking ( void ) : void

public expand ( int $len ) : bool

public freeze ( bool $at_front ) : bool

public lock ( void ) : void

public prepend ( string $data ) : bool

public prependBuffer ( EventBuffer $buf ) : bool

public pullup ( int $size ) : string

public read ( int $max_bytes ) : string

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

public readLine ( int $eol_style ) : string

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

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

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

public unfreeze ( bool $at_front ) : bool

public unlock ( void ) : bool

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

}

Retour à la première page de Manuel PHP Table des matières Haut

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.

Retour à la première page de Manuel PHP Table des matières Haut

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).

Retour à la première page de Manuel PHP Table des matières Haut

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

Rechercher une fonction PHP

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-class.eventbuffer.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut