Add more data to the window of currently valid data. To avoid expensive reallocation, use avail to tune this call.
size_t extend (
|request||The number of additional elements to add to the valid window.|
The number of elements that were actually added to the valid window. Note that this may be less than the request if more elements could not be attained from the allocator.