GI.Json.Structs.Array

JsonArray is the representation of the array type inside JSON.

A JsonArray contains [structjson.Node] elements, which may contain fundamental types, other arrays or objects.

Since arrays can be arbitrarily big, copying them can be expensive; for this reason, they are reference counted. You can control the lifetime of a JsonArray using arrayRef and arrayUnref.

To append an element, use arrayAddElement.

To extract an element at a given index, use arrayGetElement.

To retrieve the entire array in list form, use arrayGetElements.

To retrieve the length of the array, use arrayGetLength.

Exported types

newtype Array

Memory-managed wrapper type.

Constructors

Array (ManagedPtr Array)

Instances

Eq Array

Defined in GI.Json.Structs.Array

Methods

(==) :: Array -> Array -> Bool

(/=) :: Array -> Array -> Bool

GBoxed Array

Defined in GI.Json.Structs.Array

ManagedPtrNewtype Array

Defined in GI.Json.Structs.Array

Methods

toManagedPtr :: Array -> ManagedPtr Array

TypedObject Array

Defined in GI.Json.Structs.Array

Methods

glibType :: IO GType

HasParentTypes Array

Defined in GI.Json.Structs.Array

IsGValue (Maybe Array)

Convert Array to and from GValue. See toGValue and fromGValue.

Defined in GI.Json.Structs.Array

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe Array -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe Array)

type ParentTypes Array

Defined in GI.Json.Structs.Array

type ParentTypes Array = '[] :: [Type]

Methods

Click to display all available methods, including inherited ones

Methods

addArrayElement, addBooleanElement, addDoubleElement, addElement, addIntElement, addNullElement, addObjectElement, addStringElement, dupElement, equal, foreachElement, hash, isImmutable, ref, removeElement, seal, unref.

Getters

getArrayElement, getBooleanElement, getDoubleElement, getElement, getElements, getIntElement, getLength, getNullElement, getObjectElement, getStringElement.

Setters

None.

addArrayElement

arrayAddArrayElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Maybe Array

value: the array to add

-> m ()

Conveniently adds an array element into an array.

If value is NULL, a null element will be added instead.

See also: arrayAddElement, nodeTakeArray

Since: 0.8

addBooleanElement

arrayAddBooleanElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Bool

value: the boolean value to add

-> m ()

Conveniently adds the given boolean value into an array.

See also: arrayAddElement, nodeSetBoolean

Since: 0.8

addDoubleElement

arrayAddDoubleElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Double

value: the floating point value to add

-> m ()

Conveniently adds the given floating point value into an array.

See also: arrayAddElement, nodeSetDouble

Since: 0.8

addElement

arrayAddElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Node

node: the element to add

-> m ()

Appends the given node inside an array.

addIntElement

arrayAddIntElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Int64

value: the integer value to add

-> m ()

Conveniently adds the given integer value into an array.

See also: arrayAddElement, nodeSetInt

Since: 0.8

addNullElement

arrayAddNullElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> m ()

Conveniently adds a null element into an array

See also: arrayAddElement, JSON_NODE_NULL

Since: 0.8

addObjectElement

arrayAddObjectElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Maybe Object

value: the object to add

-> m ()

Conveniently adds an object into an array.

If value is NULL, a null element will be added instead.

See also: arrayAddElement, nodeTakeObject

Since: 0.8

addStringElement

arrayAddStringElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Text

value: the string value to add

-> m ()

Conveniently adds the given string value into an array.

See also: arrayAddElement, nodeSetString

Since: 0.8

dupElement

arrayDupElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Node

Returns: a copy of the element at the given position

Retrieves a copy of the element at the given position in the array.

Since: 0.6

equal

arrayEqual

Arguments

:: (HasCallStack, MonadIO m)

=> Array

a: a JSON array

-> Array

b: another JSON array

-> m Bool

Returns: TRUE if the arrays are equal, and FALSE otherwise

Check whether two arrays are equal.

Equality is defined as:

• the array have the same number of elements
• the values of elements in corresponding positions are equal

Since: 1.2

foreachElement

arrayForeachElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> ArrayForeach

func: the function to be called on each element

-> m ()

Iterates over all elements of an array, and calls a function on each one of them.

It is safe to change the value of an element of the array while iterating over it, but it is not safe to add or remove elements from the array.

Since: 0.8

getArrayElement

arrayGetArrayElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Array

Returns: the array

Conveniently retrieves the array at the given position inside an array.

See also: arrayGetElement, nodeGetArray

Since: 0.8

getBooleanElement

arrayGetBooleanElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Bool

Returns: the boolean value

Conveniently retrieves the boolean value of the element at the given position inside an array.

See also: arrayGetElement, nodeGetBoolean

Since: 0.8

getDoubleElement

arrayGetDoubleElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Double

Returns: the floating point value

Conveniently retrieves the floating point value of the element at the given position inside an array.

See also: arrayGetElement, nodeGetDouble

Since: 0.8

getElement

arrayGetElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Node

Returns: the element at the given position

Retrieves the element at the given position in the array.

getElements

arrayGetElements

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> m [Node]

Returns: the elements of the array

Retrieves all the elements of an array as a list of nodes.

getIntElement

arrayGetIntElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Int64

Returns: the integer value

Conveniently retrieves the integer value of the element at the given position inside an array.

See also: arrayGetElement, nodeGetInt

Since: 0.8

getLength

arrayGetLength

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> m Word32

Returns: the length of the array

Retrieves the length of the given array

getNullElement

arrayGetNullElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Bool

Returns: TRUE if the element is null

Conveniently checks whether the element at the given position inside the array contains a null value.

See also: arrayGetElement, nodeIsNull

Since: 0.8

getObjectElement

arrayGetObjectElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Object

Returns: the object

Conveniently retrieves the object at the given position inside an array.

See also: arrayGetElement, nodeGetObject

Since: 0.8

getStringElement

arrayGetStringElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the index of the element to retrieve

-> m Text

Returns: the string value

Conveniently retrieves the string value of the element at the given position inside an array.

See also: arrayGetElement, nodeGetString

Since: 0.8

hash

arrayHash

Arguments

:: (HasCallStack, MonadIO m)

=> Array

key: a JSON array to hash

-> m Word32

Returns: hash value for the key

Calculates a hash value for the given key.

The hash is calculated over the array and all its elements, recursively.

If the array is immutable, this is a fast operation; otherwise, it scales proportionally with the length of the array.

Since: 1.2

isImmutable

arrayIsImmutable

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> m Bool

Returns: True if the array is immutable

Check whether the given array has been marked as immutable by calling arraySeal on it.

Since: 1.2

new

arrayNew

Arguments

:: (HasCallStack, MonadIO m)

=> m Array

Returns: the newly created array

Creates a new array.

ref

arrayRef

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: the array to reference

-> m Array

Returns: the passed array, with the reference count increased by one

Acquires a reference on the given array.

removeElement

arrayRemoveElement

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: a JSON array

-> Word32

index_: the position of the element to be removed

-> m ()

Removes the element at the given position inside an array.

This function will release the reference held on the element.

seal

arraySeal

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: the array to seal

-> m ()

Seals the given array, making it immutable to further changes.

This function will recursively seal all elements in the array too.

If the array is already immutable, this is a no-op.

Since: 1.2

sizedNew

arraySizedNew

Arguments

:: (HasCallStack, MonadIO m)

=> Word32

nElements: number of slots to pre-allocate

-> m Array

Returns: the newly created array

Creates a new array with n_elements slots already allocated.

unref

arrayUnref

Arguments

:: (HasCallStack, MonadIO m)

=> Array

array: the array to unreference

-> m ()

Releases a reference on the given array.

If the reference count reaches zero, the array is destroyed and all its allocated resources are freed.