Opaque iterator for a BufferList.
buffer into the BufferList iterated
with it. The buffer is inserted into the current group, immediately before the buffer that would be returned by
next. The buffer is inserted before the implicit cursor, a subsequent
call to next will return the buffer after the inserted buffer, if any.
This function takes ownership of buffer.
it. The group is inserted immediately before the group that would be returned by
next_group. A subsequent call to
next_group will advance the iterator to the group after the
inserted group, if any.
list of buffers into the BufferList
iterated with it. The list is inserted into the current group, immediately before the buffer that would be returned by
next. The list is inserted before the implicit cursor, a subsequent call
to next will return the buffer after the last buffer of the inserted
list, if any. This function takes ownership of list and all its buffers.
it or the list. or NULL
it.
it. If the iterator is at the end of a
group, NULL will be returned. This function may be called repeatedly to iterate through the current group. The caller will not get a
new ref to the returned Buffer and must not unref it. buffer list, or NULL
it to the first buffer in the next group. If the iterator is at the
last group, FALSE will be returned. This function may be called repeatedly to iterate through the groups in a buffer list. the
iterator was already at the last group
it.
next must have been called on it before this function is
called. This function can only be called once per call to next. The
removed buffer is unreffed.
