PhpRiot
Become Zend Certified

Prepare for the ZCE exam using our quizzes (web or iPad/iPhone). More info...


When you're ready get 7.5% off your exam voucher using voucher CJQNOV23 at the Zend Store

EventBuffer::pullup

(PECL event >= 1.2.6-beta)

EventBuffer::pullupLinearizes 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.

Warning

Calling EventBuffer::pullup with a large size can be quite slow, since it potentially needs to copy the entire buffer's contents.

Parameters

size

The number of bytes required to be contiguous within the buffer.

Return Values

If size is greater than the number of bytes in the buffer, the function returns NULL. Otherwise, EventBuffer::pullup returns string.

See Also

PHP Manual