array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'eventbuffer.copyout.php', 1 => 'EventBuffer::copyout', ), 'up' => array ( 0 => 'class.eventbuffer.php', 1 => 'EventBuffer', ), 'prev' => array ( 0 => 'eventbuffer.construct.php', 1 => 'EventBuffer::__construct', ), 'next' => array ( 0 => 'eventbuffer.drain.php', 1 => 'EventBuffer::drain', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/event/eventbuffer/copyout.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL event >= 1.2.6-beta)
EventBuffer::copyout — Copies out specified number of bytes from the front of the buffer
Behaves just like
EventBuffer::read()
, but does not drain any data from the buffer. I.e. it copies the first
max_bytes
bytes from the front of the buffer into
data
. If there are fewer than
max_bytes
bytes available, the function copies all the bytes there are.
data
Output string.
max_bytes
The number of bytes to copy.
Returns the number of bytes copied, or
-1
on failure.