template<template< typename U, typename V, typename... Args > class ObjectType = std::map, template< typename U, typename... Args > class ArrayType = std::vector, class StringType = std::string, class BooleanType = bool, class NumberIntegerType = std::int64_t, class NumberUnsignedType = std::uint64_t, class NumberFloatType = double, template< typename U > class AllocatorType = std::allocator, template< typename T, typename SFINAE=void > class JSONSerializer = adl_serializer, class BinaryType = std::vector<std::uint8_t>>
template<typename KeyT >
iterator nlohmann::basic_json< ObjectType, ArrayType, StringType, BooleanType, NumberIntegerType, NumberUnsignedType, NumberFloatType, AllocatorType, JSONSerializer, BinaryType >::find |
( |
KeyT && |
key | ) |
|
|
inline |
Finds an element in a JSON object with key equivalent to key. If the element is not found or the JSON value is not an object, end() is returned.
- Note
- This method always returns end() when executed on a JSON type that is not an object.
- Parameters
-
[in] | key | key value of the element to search for. |
- Returns
- Iterator to an element with key equivalent to key. If no such element is found or the JSON value is not an object, past-the-end (see end()) iterator is returned.
- Complexity^^ Logarithmic in the size of the JSON object.
- Example^^ The example shows how find() is used. ^^ find__key_type.cpp
- Output (play with this example online):^^
"two" was found: true
value at key "two": 2
"three" was found: false
^^ The example code above can be translated withg++ -std=c++11 -Isingle_include doc/examples/find__key_type.cpp -o find__key_type
- See also
- contains(KeyT&&) const – checks whether a key exists
- Since
- version 1.0.0
Definition at line 20822 of file json.hpp.