• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# basic_json::begin
2
3```cpp
4iterator begin() noexcept;
5const_iterator begin() const noexcept;
6```
7
8Returns an iterator to the first element.
9
10![Illustration from cppreference.com](../../images/range-begin-end.svg)
11
12## Return value
13
14iterator to the first element
15
16## Exception safety
17
18No-throw guarantee: this member function never throws exceptions.
19
20## Complexity
21
22Constant.
23
24## Example
25
26??? example
27
28    The following code shows an example for `begin()`.
29
30    ```cpp
31    --8<-- "examples/begin.cpp"
32    ```
33
34    Output:
35
36    ```json
37    --8<-- "examples/begin.output"
38    ```
39
40## Version history
41
42- Added in version 1.0.0.
43