allocator_type array array_t at at at at back back basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json basic_json begin begin boolean_t cbegin cend clear const_pointer const_reference const_reverse_iterator count crbegin crend difference_type dump empty end end erase erase erase erase find find front front get get get get_allocator get_ptr get_ptr get_ref get_ref insert insert insert insert insert is_array is_boolean is_discarded is_null is_number is_number_float is_number_integer is_number_unsigned is_object is_primitive is_string is_structured iterator_wrapper iterator_wrapper max_size number_float_t number_integer_t number_unsigned_t object object_t operator value_t operator ValueType operator!= operator!= operator!= operator+= operator+= operator+= operator< operator< operator<< operator<< operator<= operator= operator== operator== operator== operator> operator>= operator>> operator>> operator[] operator[] operator[] operator[] operator[] operator[] operator[] operator[] parse parse parse parse_event_t parser_callback_t pointer push_back push_back push_back rbegin rbegin reference rend rend reverse_iterator size size_type string_t swap swap swap swap type value value value_t value_type ~basic_json

template<template< typename U, typename V, typename...Args > class ObjectType = std::map, template< typename U, typename...Args > class ArrayType = std::vector, class StringType = std::string, class BooleanType = bool, class NumberIntegerType = int64_t, class NumberUnsignedType = uint64_t, class NumberFloatType = double, template< typename U > class AllocatorType = std::allocator> template<class InteratorType , typename std::enable_if< std::is_same< InteratorType, typename basic_json_t::iterator >::value or std::is_same< InteratorType, typename basic_json_t::const_iterator >::value , int >::type = 0> InteratorType nlohmann::basic_json< ObjectType, ArrayType, StringType, BooleanType, NumberIntegerType, NumberUnsignedType, NumberFloatType, AllocatorType >::erase ( InteratorType  first, InteratorType  last  ) inline Removes the element specified by the range [first; last). Invalidates iterators and references at or after the point of the erase, including the end() iterator. The iterator first does not need to be dereferenceable if first == last: erasing an empty range is a no-op. If called on a primitive type other than null, the resulting JSON value will be null. Parameters [in] first iterator to the beginning of the range to remove [in] last iterator past the end of the range to remove Returns Iterator following the last removed element. If the iterator second refers to the last element, the end() iterator is returned. Template Parameters InteratorType an iterator or const_iterator Exceptions std::domain_error if called on a null value; example: "cannot use erase() with null" std::domain_error if called on iterators which does not belong to the current JSON value; example: "iterators do not fit current value" std::out_of_range if called on a primitive type with invalid iterators (i.e., if first != begin() and last != end()); example: "iterators out of range" Complexity The complexity depends on the type: objects: log(size()) + std::distance(first, last) arrays: linear in the distance between first and last, plus linear in the distance between last and end of the container strings: linear in the length of the string other types: constant Example The example shows the result of erase for different JSON types. #include <json.hpp> using namespace nlohmann; int main() { // create JSON values json j_boolean = true; json j_number_integer = 17; json j_number_float = 23.42; json j_object = {{"one", 1}, {"two", 2}}; json j_array = {1, 2, 4, 8, 16}; json j_string = "Hello, world"; // call erase j_boolean.erase(j_boolean.begin(), j_boolean.end()); j_number_integer.erase(j_number_integer.begin(), j_number_integer.end()); j_number_float.erase(j_number_float.begin(), j_number_float.end()); j_object.erase(j_object.find("two"), j_object.end()); j_array.erase(j_array.begin() + 1, j_array.begin() + 3); j_string.erase(j_string.begin(), j_string.end()); // print values std::cout << j_boolean << '\n'; std::cout << j_number_integer << '\n'; std::cout << j_number_float << '\n'; std::cout << j_object << '\n'; std::cout << j_array << '\n'; std::cout << j_string << '\n'; } Output (play with this example online): null null null {"one":1} [1,8,16] null The example code above can be translated with g++ -std=c++11 -Isrc doc/examples/erase__IteratorType_IteratorType.cpp -o erase__IteratorType_IteratorType See also erase(InteratorType) – removes the element at a given position erase(const typename object_t::key_type&) – removes the element from an object at the given key erase(const size_type) – removes the element from an array at the given index Since version 1.0.0 Definition at line 3756 of file json.hpp.