append_options Struct Reference

Options for binary_collection::append(). More...

#include <couchbase/append_options.hxx>

Inheritance diagram for append_options:

Classes
struct	built
	Immutable value object representing consistent options. More...

Public Member Functions
auto	build () const -> built
	Validates options and returns them as an immutable value.
auto	cas (couchbase::cas cas) -> append_options &
	Specifies a CAS value that will be taken into account on the server side for optimistic concurrency.
Public Member Functions inherited from common_durability_options< append_options >
auto	durability (durability_level level) -> append_options &
	Allows to customize the enhanced durability requirements for this operation.
auto	durability (persist_to persist_to_nodes, replicate_to replicate_to_nodes) -> append_options &
	Allows to customize the poll-based durability requirements for this operation.
Public Member Functions inherited from common_options< append_options >
auto	timeout (const std::chrono::milliseconds timeout) -> append_options &
	Specifies a custom per-operation timeout.
auto	retry_strategy (const std::shared_ptr< retry_strategy > strategy) -> append_options &
	Specifies a custom couchbase::retry_strategy for this operation.
auto	parent_span (std::shared_ptr< tracing::request_span > span) -> append_options &

Additional Inherited Members
Protected Member Functions inherited from common_durability_options< append_options >
auto	build_common_durability_options () const -> built
Protected Member Functions inherited from common_options< append_options >
auto	build_common_options () const -> built
auto	self () -> append_options &
	Allows to return the right options builder instance for child implementations.

Detailed Description

Options for binary_collection::append().

Since

1.0.0

Committed

Generally available API and should be preferred in production

Member Function Documentation

build()

auto build ( ) const -> built

inlinenodiscard

Validates options and returns them as an immutable value.

Returns

consistent options as an immutable value

Exceptions

std::system_error

with code errc::common::invalid_argument if the options are not valid

Since

1.0.0

Internal

Internal interface

cas()

auto cas ( couchbase::cas cas ) -> append_options&

inline

Specifies a CAS value that will be taken into account on the server side for optimistic concurrency.

The CAS value is an opaque identifier which is associated with a specific state of the document on the server. The CAS value is received on read operations (or after mutations) and can be used during a subsequent mutation to make sure that the document has not been modified in the meantime.

If document on the server has been modified in the meantime the SDK will raise a errc::common::cas_mismatch. In this case the caller is expected to re-do the whole "fetch-modify-update" cycle again. Please refer to the SDK documentation for more information on CAS mismatches and subsequent retries.

Parameters

cas	the opaque CAS identifier to use for this operation.

Returns

the append_options for chaining purposes.

---

The documentation for this struct was generated from the following file:

• couchbase/append_options.hxx