Insert [first, last)] at index in the held array.

Synopsis

Declared in <bdljsn_json.h>

template<
    class t_INDEX,
    class t_INPUT_ITERATOR>
JsonArray::Iterator
insert(
    t_INDEX index,
    t_INPUT_ITERATOR first,
    t_INPUT_ITERATOR last)
requires bsl::is_integral<t_INDEX>::value
                        && !bsl::is_same<t_INDEX, bool>::value;

Description

Insert into the JsonArray held by this object at the specified index the values in the range [first, last)], and return an iterator referring to the first newly inserted element. If isNull(), then the type is changed to array and index must be 0. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() + distance(first, last) > maxSize(). The (template parameter) type t_INDEX must be a non‐`bool` integral type. The behavior is undefined unless isArray() or isNull(), and unless index is in the range [0 .. size()].

Return Value

an iterator referring to the newly inserted element

Parameters

Name

Description

index

insertion position

first

beginning of the source range

last

end of the source range

Created with MrDocs