mirror of
https://github.com/nlohmann/json.git
synced 2024-08-22 13:02:28 +02:00
56 lines
1.2 KiB
Markdown
56 lines
1.2 KiB
Markdown
|
# nlohmann::basic_json::empty
|
||
|
|
||
|
```cpp
|
||
|
bool empty() const noexcept;
|
||
|
```
|
||
|
|
||
|
Checks if the container has no elements; that is, whether `begin() == end()`.
|
||
|
|
||
|
## Parameters
|
||
|
|
||
|
(none)
|
||
|
|
||
|
## Return value
|
||
|
|
||
|
`true` if the container is empty, `false` otherwise. Note that the JSON types string, number, and boolean are never empty, null values are always empty.
|
||
|
|
||
|
## Exceptions
|
||
|
|
||
|
`noexcept` specification: `noexcept`.
|
||
|
|
||
|
## Complexity
|
||
|
|
||
|
Constant (assuming types `ObjectType` and `ArrayType` satisfy the [Container](http://en.cppreference.com/w/cpp/concept/Container) concept).
|
||
|
|
||
|
## Example
|
||
|
|
||
|
The following code uses empty to check if a `json` container contains any elements:
|
||
|
|
||
|
```cpp
|
||
|
#include <json.hpp>
|
||
|
#include <iostream>
|
||
|
|
||
|
int main()
|
||
|
{
|
||
|
nlohman::json numbers;
|
||
|
std::cout << "Initially, numbers.empty(): " << numbers.empty() << '\n';
|
||
|
|
||
|
numbers.push_back(42);
|
||
|
numbers.push_back(13317);
|
||
|
std::cout << "After adding elements, numbers.empty(): " << numbers.empty() << '\n';
|
||
|
}
|
||
|
```
|
||
|
|
||
|
### Output
|
||
|
|
||
|
Initially, numbers.empty(): 1
|
||
|
After adding elements, numbers.empty(): 0
|
||
|
|
||
|
## Requirements
|
||
|
|
||
|
The `empty` member function is part of the [Container](http://en.cppreference.com/w/cpp/concept/Container) requirement.
|
||
|
|
||
|
## See also
|
||
|
|
||
|
- `size()`
|