firebase::database::MutableData

#include <mutable_data.h>

Instances of this class encapsulate the data and priority at a location.

Summary

It is used in transactions, and it is intended to be inspected and then updated to the desired data at that location.

Constructors and Destructors

~MutableData()
Destructor.

Public functions

Child(const char *path)
Used to obtain aMutableData instance that encapsulates the data and priority at the given relative path.
Child(const std::string & path)
Used to obtain aMutableData instance that encapsulates the data and priority at the given relative path.
HasChild(const char *path) const
bool
Does thisMutableData have data at a particular location?
HasChild(const std::string & path) const
bool
Does thisMutableData have data at a particular location?
children()
std::vector<MutableData >
Get all the immediate children of this location.
children_count()
size_t
Get the number of children of this location.
key() const
const char *
Get the key name of the source location of this data.
key_string() const
std::string
Get the key name of the source location of this data.
priority()
Get the priority of the data contained at this snapshot.
set_priority(constVariant & priority)
void
Sets the priority of this field, which controls its sort order relative to its siblings.
set_value(constVariant & value)
void
Sets the data at this location to the given value.
value() const
Get the value of the data contained at this location.

Public functions

Child

MutableDataChild(constchar*path)

Used to obtain aMutableData instance that encapsulates the data and priority at the given relative path.

Note that changes made to a childMutableData instance will be visible to the parent and vice versa.

Details
Parameters
path
Path relative to this snapshot's location. The pointer only needs to be valid during this call.
Returns
MutableData for the Child relative to this location. The memory will be freed when the Transaction is finished.

Child

MutableDataChild(conststd::string&path)

Used to obtain aMutableData instance that encapsulates the data and priority at the given relative path.

Details
Parameters
path
Path relative to this snapshot's location.
Returns
MutableData for the Child relative to this location. The memory will be freed when the Transaction is finished.

HasChild

boolHasChild(constchar*path)const

Does thisMutableData have data at a particular location?

Details
Parameters
path
Path relative to this data's location. The pointer only needs to be valid during this call.
Returns
True if there is data at the specified location, false if not.

HasChild

boolHasChild(conststd::string&path)const

Does thisMutableData have data at a particular location?

Details
Parameters
path
Path relative to this data's location.
Returns
True if there is data at the specified location, false if not.

children

std::vector<MutableData>children()

Get all the immediate children of this location.

Details
Returns
The immediate children of this location.

children_count

size_tchildren_count()

Get the number of children of this location.

Details
Returns
The number of immediate children of this location.

key

constchar*key()const

Get the key name of the source location of this data.

Note: The returned pointer is only guaranteed to be valid during the transaction.

Details
Returns
Key name of the source location of this data.

priority

Variantpriority()

Get the priority of the data contained at this snapshot.

Details
Returns
The value of this location's Priority relative to its siblings.

set_priority

voidset_priority(constVariant&priority)

Sets the priority of this field, which controls its sort order relative to its siblings.

See also:firebase::database::DatabaseReference::SetPriority() for information on how Priority affects the ordering of a node'schildren.

Details
Parameters
priority
Sort priority for this child relative to its siblings. TheVariant types accepted are Null, Int64, Double, and String. Other types will return kErrorInvalidVariantType.

set_value

voidset_value(constVariant&value)

Sets the data at this location to the given value.

Details
Parameters
value
The value to set this location to. TheVariant's type corresponds to the types accepted by the database JSON: Null: Deletes this location from the database. Int64: Inserts an integer value into this location. Double: Inserts a floating point value into this location. String: Inserts a string into this location. (Accepts both Mutable and Static strings) Vector: Inserts a JSON array into this location. The elements can be anyVariant type, including Vector and Map. Map: Inserts a JSON associative array into this location. The keys must be of type String (or Int64/Double which are converted to String). The values can be anyVariant type, including Vector and Map.

value

Variantvalue()const

Get the value of the data contained at this location.

Details
Returns
The value of the data contained at this location.

~MutableData

~MutableData()

Destructor.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024-01-23 UTC.