Provides an interface to specify a path to a key in a document that you can then call various update functions on. More...

#include <MutableDocumentPath.hpp>

Inheritance diagram for ditto::MutableDocumentPath:

Public Member Functions
MutableDocumentPath	operator[] (std::string key)

MutableDocumentPath	operator[] (std::size_t index)

std::shared_ptr< AttachmentToken >	get_attachment_token () const
	Returns the value at the previously specified key in the document as a `std::shared_ptr<AttachmentToken>`. If the key was invalid the return value will be a `nullptr`.

std::shared_ptr< MutableCounter >	get_counter () const
	Returns the value at the previously specified key in the document as a `std::shared_ptr<MutableCounter>`. If the key was invalid the return value will be a `nullptr`.

std::shared_ptr< MutableRegister >	get_register () const
	Returns the value at the previously specified key in the document as a `std::shared_ptr<MutableRegister>`. If the key was invalid the return value will be a `nullptr`.

std::shared_ptr< Rga >	get_rga () const DITTO_DEPRECATED
	Returns the value at the previously specified key in the document as a `std::shared_ptr<Rga>`. If the key was invalid the return value will be a `nullptr`.

void	set (nlohmann::json value, bool is_default=false) const
	Set a value at the document's key defined by the preceding subscripting.

void	remove () const
	Remove a value at the document's key defined by the preceding subscripting.

Public Member Functions inherited from ditto::AbstractDocumentPath
nlohmann::json	get_json (PathAccessorType path_type) const

AbstractDocumentPath	operator[] (std::string path)
	Used to specify a path to a key in the document that you can subscript further to access a nested key in the document and eventually perform an update operation on.

AbstractDocumentPath	operator[] (std::size_t index)
	Used to specify an index in the array at the preceding key-path specified through the subscripting defined previously. You can subscript the return value further to access a further nested key in the document and eventually perform an update operation.

std::string	get_string_value () const
	Returns the value at the previously specified key in the document as a `std::string`. If the key was invalid a default value of an empty string will be returned.

int	get_int_value () const
	Returns the value at the previously specified key in the document as an `int`. If the key was invalid a default value of 0 will be returned.

double	get_double_value () const
	Returns the value at the previously specified key in the document as a `double`. If the key was invalid a default value of 0 will be returned.

float	get_float_value () const
	Returns the value at the previously specified key in the document as a `float`. If the key was invalid a default value of 0 will be returned.

bool	get_bool_value () const
	Returns the value at the previously specified key in the document as a `bool`. If the key was invalid a default value of false will be returned.

nlohmann::json	get_json () const
	Returns the value at the previously specified key in the document as a `nlohmann::json` object. If the key was invalid the return value will be a `nullptr`.

Additional Inherited Members
Protected Member Functions inherited from ditto::AbstractDocumentPath
	AbstractDocumentPath (CDocument_t const *document, DocumentId id, std::string initial_path)
	Constructs a new initial `AbstractDocumentPath` for a document.

	AbstractDocumentPath (const AbstractDocumentPath *document_path, std::string key)
	Constructs a new `AbstractDocumentPath` from an existing `AbstractDocumentPath` by appending a path.

	AbstractDocumentPath (const AbstractDocumentPath *document_path, std::size_t index)
	Constructs a new `AbstractDocumentPath` from an existing `AbstractDocumentPath` by appending an index.

	AbstractDocumentPath (const AbstractDocumentPath *document_path)
	Copy constructor.

template<typename T >
T	get_primitive_or_default (T default_value, json_callback json_cb, PathAccessorType path_type) const
	Get the primitive stored at a given path or the correspondign default value.

template<typename T >
std::shared_ptr< T >	get_object_or_default (json_callback json_cb, PathAccessorType path_type) const
	Helper function to retrieve crdt objects.

template<typename T >
std::shared_ptr< T >	get_mut_object_or_default (json_callback json_cb, PathAccessorType path_type) const

Protected Attributes inherited from ditto::AbstractDocumentPath
CDocument_t const *	document

DocumentId	id

std::string	path

Detailed Description

Provides an interface to specify a path to a key in a document that you can then call various update functions on.

You obtain a MutableDocumentPath by subscripting a MutableDocument and you can then further subscript a MutableDocumentPath to further specify the key of the document that you want to update.

Member Function Documentation

◆ get_attachment_token()

std::shared_ptr< AttachmentToken > ditto::MutableDocumentPath::get_attachment_token ( ) const

Returns the value at the previously specified key in the document as a std::shared_ptr<AttachmentToken>. If the key was invalid the return value will be a nullptr.

Returns: The value at the path specified by the document subscripting as a std::shared_ptr<AttachmentToken>. The return value will be a nullptr if the key was invalid or the value was not an AttachmentToken object.

◆ get_counter()

std::shared_ptr< MutableCounter > ditto::MutableDocumentPath::get_counter ( ) const

Returns the value at the previously specified key in the document as a std::shared_ptr<MutableCounter>. If the key was invalid the return value will be a nullptr.

Returns: The value at the path specified by the document subscripting as a std::shared_ptr<MutableCounter>. The return value will be a nullptr if the key was invalid or the value was not a Counter object.

◆ get_register()

std::shared_ptr< MutableRegister > ditto::MutableDocumentPath::get_register ( ) const

Returns the value at the previously specified key in the document as a std::shared_ptr<MutableRegister>. If the key was invalid the return value will be a nullptr.

Returns: The value at the path specified by the document subscripting as a std::shared_ptr<MutableRegister>. The return value will be a nullptr if the key was invalid or the value was not a register object.

◆ get_rga()

std::shared_ptr< Rga > ditto::MutableDocumentPath::get_rga ( ) const

Returns the value at the previously specified key in the document as a std::shared_ptr<Rga>. If the key was invalid the return value will be a nullptr.

Note: The returned type, Rga, is deprecated and does not allow any mutation. RGAs cannot be created or mutated with this version of the SDK; they can only be read and this is for backwards compatibility reasons.

Returns: The value at the path specified by the document subscripting as a std::shared_ptr<Rga>. The return value will be a nullptr if the key was invalid or the value was not an Rga object.

◆ remove()

void ditto::MutableDocumentPath::remove ( ) const

Remove a value at the document's key defined by the preceding subscripting.

Exceptions

DittoError thrown if trying to update the document at an invalid key.

◆ set()

void ditto::MutableDocumentPath::set	(	nlohmann::json	value,
		bool	is_default = `false`
	)		const

Set a value at the document's key defined by the preceding subscripting.

Parameters

value	the value to set at the subscripting-defined document key.
is_default	represents whether or not the value should be set as a default value. Set this to `true` if you want to set a default value that you expect to be overwritten by other devices in the network. The default value is `false`.