json/docs/mkdocs/docs/api/basic_json/std_swap.md

std::swap<basic_json>

namespace std {
    void swap(nlohmann::basic_json& j1, nlohmann::basic_json& j2);
}

Exchanges the values of two JSON objects.

Parameters

j1 (in, out)

value to be replaced by j2

j2 (in, out)

value to be replaced by j1

Exception safety

No-throw guarantee: this function never throws exceptions.

Complexity

Constant.

Possible implementation

void swap(nlohmann::basic_json& j1, nlohmann::basic_json& j2)
{
    j1.swap(j2);
}

Examples

??? example

The following code shows how two values are swapped with `std::swap`.
 
```cpp
--8<-- "examples/std_swap.cpp"
```

Output:

```json
--8<-- "examples/std_swap.output"
```

See also

• swap

Version history

• Added in version 1.0.0.
• Extended for arbitrary basic_json types in version 3.10.5.