mirror of
https://github.com/nlohmann/json.git
synced 2026-10-13 10:14:53 +00:00
64 lines
1.3 KiB
Markdown
64 lines
1.3 KiB
Markdown
# <small>nlohmann::basic_json::</small>get_allocator
|
|
|
|
```cpp
|
|
static allocator_type get_allocator();
|
|
```
|
|
|
|
Returns the allocator associated with the container.
|
|
|
|
## Return value
|
|
|
|
associated allocator
|
|
|
|
## Exception safety
|
|
|
|
Strong guarantee: if an exception is thrown, there are no changes to any JSON value.
|
|
|
|
## Complexity
|
|
|
|
Constant.
|
|
|
|
## Examples
|
|
|
|
??? example
|
|
|
|
The example shows how `get_allocator()` is used to created `json` values.
|
|
|
|
```cpp
|
|
#include <iostream>
|
|
#include <nlohmann/json.hpp>
|
|
|
|
using json = nlohmann::json;
|
|
|
|
int main()
|
|
{
|
|
auto alloc = json::get_allocator();
|
|
using traits_t = std::allocator_traits<decltype(alloc)>;
|
|
|
|
json* j = traits_t::allocate(alloc, 1);
|
|
traits_t::construct(alloc, j, "Hello, world!");
|
|
|
|
std::cout << *j << std::endl;
|
|
|
|
traits_t::destroy(alloc, j);
|
|
traits_t::deallocate(alloc, j, 1);
|
|
}
|
|
|
|
```
|
|
|
|
Output:
|
|
|
|
```json
|
|
"Hello, world!"
|
|
|
|
```
|
|
|
|
## See also
|
|
|
|
- [basic_json](index.md#template-parameters) the class template, with `AllocatorType` as one of its template parameters
|
|
- [Template Parameter Requirements](../../features/types/template_parameters.md#allocatortype) - the requirements for `AllocatorType`
|
|
|
|
## Version history
|
|
|
|
- Added in version 1.0.0.
|