Function insert

Source/Utils/json.hpp:22021–22037

! @brief inserts element Inserts element @a val before iterator @a pos. @param[in] pos iterator before which the content will be inserted; may be the end() iterator @param[in] val element to insert @return iterator pointing to the inserted @a val. @throw type_error.309 if called on JSON values other than arrays; example: `"cannot u

        @since version 1.0.0
        */
        iterator insert(const_iterator pos, const basic_json& val)
        {
            // insert only works for arrays
            if (JSON_HEDLEY_LIKELY(is_array()))
            {
                // check if iterator pos fits to this JSON value
                if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
                {
                    JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value"));
                }

                // insert to array and return iterator
                return insert_iterator(pos, val);
            }

            JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name())));
        }

        /*!
        @brief inserts element