Niels Lohmann
7b755737b4
From gregmarr's review of #5622: - count() counts every member with the key, so count(key) > 1 detects duplicate keys; it was contains() as 0/1 before. - get_to() passes types that get<T>() does not convert directly to from_json with the existing value, as basic_json::get_to() does, so that a from_json which sets only the fields present keeps the others. - array_index() checks the empty token and "-" first; the results are unchanged. - Docs: no "if an exception is thrown" where a view never changes anything; the borrowed source must also stay unmodified; items() on a temporary view is safe; back()/front() notes shortened; the basic_json see-also entries say how the view's results can differ. Signed-off-by: Niels Lohmann <mail@nlohmann.me>
2.2 KiB
nlohmann::basic_json_view::begin
iterator begin() const noexcept;
Returns an iterator to the first element of an array, or the first member value of an object, in document order
-- the order the values appear in the source text, not sorted by key. A primitive value iterates as a range of one
element (itself); #!json null and a discarded view iterate as an empty range.
Return value
Iterator to the first element.
Exception safety
No-throw guarantee: this function never throws exceptions.
Complexity
Constant.
Notes
For an object, iteration visits every member, including all occurrences of a duplicate key -- unlike
operator[], at, find, and contains,
which all resolve to the first member with a given key. See the
Notes on duplicate keys of operator[].
Because objects are iterated in document order rather than sorted by key, the order seen here can differ from what
iterating the materialize()d BasicJsonType value would produce: a #!cpp basic_json object
(std::map-backed by default) sorts its keys, while a view does not.
An ordered_json value also keeps document order, but it keeps only one entry per key: as parse() does, it keeps the
last value, at the position of the key's first occurrence. The view, in contrast, visits every member, including
the duplicates.
Examples
??? example
The example below iterates a log record's members with `begin()`/[`end()`](end.md) and prints them in the order
they were written. Materializing the record into a `BasicJsonType` object and iterating that would instead print
the members sorted by key.
```cpp
--8<-- "examples/basic_json_view__begin.cpp"
```
Output:
```json
--8<-- "examples/basic_json_view__begin.output"
```
See also
- end - returns an iterator to one past the last element
- cbegin - returns a const iterator to the first element
- items - access iterator member functions in range-based for
BasicJsonType::begin- the corresponding function ofbasic_json
Version history
- Added in version 3.13.0.