Class: Rev::Buffer

High speed buffering geared towards non-blocking I/O. This was largely written in response to String#slice! being incredibly slow in Ruby 1.9.

Data is stored in a byte queue implemented as a linked list of equal size chunks. Since every node in the list is the same size they are easily memory pooled. Routines are provided for high speed non-blocking reads and writes from Ruby IO objects.

Methods

<< append clear empty? new prepend read read_from size to_str write_to

Public Class methods

new(...)

Method implementations

Public Instance methods

Rev::Buffer#append(data) → String

Append the given data to the end of the buffer

Rev::Buffer#append(data) → String

Append the given data to the end of the buffer

Rev::Buffer#clear → nil

Clear all data from the Rev::Buffer

Rev::Buffer#empty? → Boolean

Is the buffer empty?

Rev::Buffer#prepend(data) → String

Prepend the given data to the beginning of the buffer

Rev::Buffer#read(length = nil) → String

Read the specified abount of data from the buffer. If no value is given the entire contents of the buffer are returned. Any data read from the buffer is cleared.

Rev::Buffer#read_from(io) → Integer

Perform a nonblocking read of the the given IO object and fill the buffer with any data received. The call will read as much data as it can until the read would block.

Rev::Buffer#size → Integer

Return the size of the buffer in bytes

Rev::Buffer#to_str → String

Convert the Buffer to a String. The original buffer is unmodified.

Rev::Buffer#write_to(io) → Integer

Perform a nonblocking write of the buffer to the given IO object. As much data as possible is written until the call would block. Any data which is written is removed from the buffer.