boost::capy::any_buffer_source::pull

Pull buffer data from the source.

Synopsis

auto
pull(std::span<const_buffer> dest);

Description

Fills the provided span with buffer descriptors from the underlying source. The operation completes when data is available, the source is exhausted, or an error occurs.

Preconditions

The wrapper must contain a valid source (has_value() == true). The caller must not call this function again after a prior call returned an error.

Return Value

An awaitable yielding (error_code,std::span<const_buffer>). On success with data, a non‐empty span of filled buffers. On EOF, ec == cond::eof and span is empty.

Parameters

Name Description

dest

Span of const_buffer to fill.

Created with MrDocs