json.object

Module for [ObjectWrap] class

Types 1

[json.object.ObjectWrap] is the representation of the object type inside JSON.

A [json.object.ObjectWrap] contains [json.node.Node] "members", which may contain fundamental types, arrays or other objects; each member of an object is accessed using a unique string, or "name".

Since objects can be arbitrarily big, copying them can be expensive; for this reason they are reference counted. You can control the lifetime of a [json.object.ObjectWrap] using [json.object.ObjectWrap.ref_] and [json.object.ObjectWrap.unref].

To add or overwrite a member with a given name, use [json.object.ObjectWrap.setMember].

To extract a member with a given name, use [json.object.ObjectWrap.getMember].

To retrieve the list of members, use [json.object.ObjectWrap.getMembers].

To retrieve the size of the object (that is, the number of members it has), use [json.object.ObjectWrap.getSize].

Methods
void * _cPtr(Flag!"Dup" dup = No.Dup)
GType _gType() @property
ObjectWrap self()Returns `this`, for use in `with` statements.
void addMember(string memberName, json.node.Node node)Adds a new member for the given name and value into an object.
json.node.Node dupMember(string memberName)Retrieves a copy of the value of the given member inside an object.
bool equal(json.object.ObjectWrap b)Check whether `a` and `b` are equal objects, meaning they have the same set of members, and the values of corresponding members are equal.
void foreachMember(json.types.ObjectForeach func)Iterates over all members of object and calls func on each one of them.
json.array.Array getArrayMember(string memberName)Convenience function that retrieves the array stored in membername of object. It is an error to specify a membername which does not exist.
bool getBooleanMember(string memberName)Convenience function that retrieves the boolean value stored in membername of object. It is an error to specify a membername which does not exist.
bool getBooleanMemberWithDefault(string memberName, bool defaultValue)Convenience function that retrieves the boolean value stored in member_name of object.
double getDoubleMember(string memberName)Convenience function that retrieves the floating point value stored in membername of object. It is an error to specify a membername which does not exist.
double getDoubleMemberWithDefault(string memberName, double defaultValue)Convenience function that retrieves the floating point value stored in member_name of object.
long getIntMember(string memberName)Convenience function that retrieves the integer value stored in membername of object. It is an error to specify a membername which does not exist.
long getIntMemberWithDefault(string memberName, long defaultValue)Convenience function that retrieves the integer value stored in member_name of object.
json.node.Node getMember(string memberName)Retrieves the value of the given member inside an object.
string[] getMembers()Retrieves all the names of the members of an object.
bool getNullMember(string memberName)Convenience function that checks whether the value stored in membername of object is null. It is an error to specify a membername which does not exist.
json.object.ObjectWrap getObjectMember(string memberName)Convenience function that retrieves the object stored in membername of object. It is an error to specify a membername which does not exist.
uint getSize()Retrieves the number of members of a JSON object. Returns: the number of members
string getStringMember(string memberName)Convenience function that retrieves the string value stored in membername of object. It is an error to specify a membername that does not exist.
string getStringMemberWithDefault(string memberName, string defaultValue)Convenience function that retrieves the string value stored in member_name of object.
json.node.Node[] getValues()Retrieves all the values of the members of an object. Returns: the member values of the object
bool hasMember(string memberName)Checks whether object has a member named member_name.
uint hash()Calculate a hash value for the given key (a JSON object).
bool isImmutable()Checks whether the given object has been marked as immutable by calling [json.object.ObjectWrap.seal] on it. Returns: `TRUE` if the object is immutable
void removeMember(string memberName)Removes member_name from object, freeing its allocated resources.
void seal()Seals the object, making it immutable to further changes.
void setArrayMember(string memberName, json.array.Array value)Convenience function for setting an object member with an array value.
void setBooleanMember(string memberName, bool value)Convenience function for setting an object member with a boolean value.
void setDoubleMember(string memberName, double value)Convenience function for setting an object member with a floating point value.
void setIntMember(string memberName, long value)Convenience function for setting an object member with an integer value.
void setMember(string memberName, json.node.Node node)Sets the value of a member inside an object.
void setNullMember(string memberName)Convenience function for setting an object member with a `null` value.
void setObjectMember(string memberName, json.object.ObjectWrap value)Convenience function for setting an object member with an object value.
void setStringMember(string memberName, string value)Convenience function for setting an object member with a string value.
Constructors
this(void * ptr, Flag!"Take" take)
this()Creates a new object. Returns: the newly created object