google::cloud::storage_experimental::AsyncReadObjectRangeResponse Struct Reference

Represents the response from reading a subset of an object. More...

#include <google/cloud/storage/async_object_responses.h>

Public Attributes
Status	status
	The final status of the download. More...
absl::optional< storage::ObjectMetadata >	object_metadata
	If available, the full object metadata. More...
std::vector< std::string >	contents
	The object contents. More...
std::multimap< std::string, std::string >	request_metadata
	Per-request metadata and annotations. More...

Detailed Description

Represents the response from reading a subset of an object.

Member Data Documentation

contents

std::vector<std::string> google::cloud::storage_experimental::AsyncReadObjectRangeResponse::contents

The object contents.

The library receives the object contents as a sequence of std::string. To avoid copies the library returns the sequence to the application. If you need to consolidate the contents use something like:

AsyncReadObjectRangeResponse response = ...;
auto all = std::accumulate(
    response.contents.begin(), response.contents.end(), std::string{},
    [](auto a, auto b) { a += b; return a; });

object_metadata

absl::optional<storage::ObjectMetadata> google::cloud::storage_experimental::AsyncReadObjectRangeResponse::object_metadata

If available, the full object metadata.

request_metadata

std::multimap<std::string, std::string> google::cloud::storage_experimental::AsyncReadObjectRangeResponse::request_metadata

Per-request metadata and annotations.

These are intended as debugging tools. They are subject to change without notice.

status

Status google::cloud::storage_experimental::AsyncReadObjectRangeResponse::status

The final status of the download.

Downloads can have partial failures, where only a subset of the data is successfully downloaded, and then the connection is interrupted. With the default configuration, the client library resumes the download. If, however, the storage::RetryPolicy is exhausted, only the partial results are returned, and the last error status is returned here.