mirror of
https://github.com/nlohmann/json.git
synced 2026-10-22 05:58:12 +00:00
75 lines
2.1 KiB
Markdown
75 lines
2.1 KiB
Markdown
# <small>nlohmann::basic_json_view::</small>cend
|
|
|
|
```cpp
|
|
iterator cend() const noexcept;
|
|
```
|
|
|
|
Returns an iterator to one past the last element, in [document order](begin.md). Equivalent to [`end()`](end.md): a
|
|
view is always read-only, so `#!cpp const_iterator` and `#!cpp iterator` are the same type, and `cend()` exists only
|
|
so that generic code that expects a `cbegin()`/`cend()` pair works with a view too.
|
|
|
|
## Return value
|
|
|
|
Iterator one past the last element; identical to what [`end()`](end.md) returns.
|
|
|
|
## Exception safety
|
|
|
|
No-throw guarantee: this function never throws exceptions.
|
|
|
|
## Complexity
|
|
|
|
Constant.
|
|
|
|
## Examples
|
|
|
|
??? example
|
|
|
|
The example below checks that every record of a batch is an object with `std::all_of`, using
|
|
[`cbegin()`](cbegin.md)/`cend()` as the range -- the same way it would for any standard container -- before
|
|
materializing any record of the batch.
|
|
|
|
```cpp
|
|
#include <algorithm>
|
|
#include <iostream>
|
|
#include <nlohmann/json_view.hpp>
|
|
|
|
using json_document = nlohmann::json_document;
|
|
using json_view = nlohmann::json_view;
|
|
|
|
int main()
|
|
{
|
|
// check that every element of a (possibly large) batch is an object,
|
|
// before materializing any of them -- cbegin()/cend() (identical to
|
|
// begin()/end() here) work as the range for std::all_of like they would
|
|
// for any standard container
|
|
json_document batch = json_document::parse(R"([{"id": 1}, {"id": 2}, {"id": 3}])");
|
|
const auto records = batch.root();
|
|
|
|
const bool all_objects = std::all_of(records.cbegin(), records.cend(),
|
|
[](const json_view & v)
|
|
{
|
|
return v.is_object();
|
|
});
|
|
|
|
std::cout << std::boolalpha << all_objects << '\n';
|
|
}
|
|
|
|
```
|
|
|
|
Output:
|
|
|
|
```json
|
|
true
|
|
|
|
```
|
|
|
|
## See also
|
|
|
|
- [end](end.md) - returns an iterator to one past the last element
|
|
- [cbegin](cbegin.md) - returns a const iterator to the first element
|
|
- [`BasicJsonType::cend`](../basic_json/cend.md) - the corresponding function of `basic_json`
|
|
|
|
## Version history
|
|
|
|
- Added in version 3.13.0.
|