PureBasic

AddJSONElement()

Синтаксис

Result = AddJSONElement(JSONValue [, Index])

Описание


Добавляет новый элемент к массиву в JSON-значении типа #PB_JSON_Array.

Параметры

JSONValue JSON-значение, в массив которого добавляется новый элемент. Это JSON-значение должно быть типа #PB_JSON_Array.
Index (дополн.) Индекс, с которым новый элемент будет вставлен в массив. Если индекс находится вне диапазона массива, новый элемент будет вставлен либо в начале (для индекса <0), либо в конце массива. Если этот параметр не указан, новый элемент добавляется в конце массива.

Возвращаемое значение

Возвращает адрес добавленного элемента массива JSON-значения. Новый добавленный элемент изначально имеет тип #PB_JSON_Null, который в последствии может быть изменён, для каждого элемента массива отдельно.

Пример

If CreateJSON(0)
    ArrayValue = SetJSONArray(JSONValue(0))

    ; Добавить элемент в конец массива, 5 раз
    For i = 1 To 5
        NumValue = AddJSONElement(ArrayValue)
        SetJSONInteger(NumValue, i)
    Next i

    ; Вставить элемент по указанному индексу
    StrValue = AddJSONElement(ArrayValue, 1)
    SetJSONString(StrValue, "Hello")

    Debug ComposeJSON(0)
EndIf

; Результат  : [1, "Hello", 2, 3, 4, 5]
; Примечание : Массив как обычно в скобках "[" "]"

См. также

SetJSONArray(), RemoveJSONElement(), ResizeJSONElements(), ClearJSONElements(), GetJSONElement(), JSONArraySize(), JSONType()

Поддерживаемые OS

Все

Оглавление Json - AddJSONMember() ->