1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
### jsoncons::basic_json::emplace
```cpp
template <typename... Args>
array_iterator emplace(Args&&... args);
template <typename... Args>
array_iterator emplace(const_array_iterator pos, Args&&... args);
```
Constructs a new json element at the specified position of a json array, shifting all elements currently at or above that position to the right.
#### Parameters
pos
Iterator that identifies the position in the array to construct the new json value
args
Arguments to forward to the constructor of the json value
#### Return value
Array iterator pointing to the emplaced value.
#### Exceptions
Throws `std::domain_error` if not a json array.
### Example
```cpp
json a(json_array_arg);
a.emplace_back("Toronto");
a.emplace_back("Vancouver");
a.emplace(a.array_range().begin(),"Montreal");
std::cout << a << '\n';
```
Output:
```json
["Montreal","Toronto","Vancouver"]
```
|
