</code></pre></div><ol><li>Finds an element in a JSON object with a key equivalent to <code>key</code>. If the element is not found or the JSON value is not an object, <code>end()</code> is returned.</li><li>See 1. This overload is only available if <code>KeyType</code> is comparable with <codeclass=highlight><spanclass=k>typename</span><spanclass=w></span><spanclass=nc>object_t</span><spanclass=o>::</span><spanclass=n>key_type</span></code> and <codeclass=highlight><spanclass=k>typename</span><spanclass=w></span><spanclass=nc>object_comparator_t</span><spanclass=o>::</span><spanclass=n>is_transparent</span></code> denotes a type.</li></ol><h2id=template-parameters>Template parameters<aclass=headerlinkhref=#template-parameterstitle="Permanent link">¶</a></h2><dl><dt><code>KeyType</code></dt><dd>A type for an object key other than <ahref=../../json_pointer/><code>json_pointer</code></a> that is comparable with <ahref=../string_t/><code>string_t</code></a> using <ahref=../object_comparator_t/><code>object_comparator_t</code></a>. This can also be a string view (C++17).</dd></dl><h2id=parameters>Parameters<aclass=headerlinkhref=#parameterstitle="Permanent link">¶</a></h2><dl><dt><code>key</code> (in)</dt><dd>key value of the element to search for.</dd></dl><h2id=return-value>Return value<aclass=headerlinkhref=#return-valuetitle="Permanent link">¶</a></h2><p>Iterator to an element with a key equivalent to <code>key</code>. If no such element is found or the JSON value is not an object, a past-the-end iterator (see <code>end()</code>) is returned.</p><h2id=exception-safety>Exception safety<aclass=headerlinkhref=#exception-safetytitle="Permanent link">¶</a></h2><p>Strong exception safety: if an exception occurs, the original value stays intact.</p><h2id=complexity>Complexity<aclass=headerlinkhref=#complexitytitle="Permanent link">¶</a></h2><p>Logarithmic in the size of the JSON object.</p><h2id=notes>Notes<aclass=headerlinkhref=#notestitle="Permanent link">¶</a></h2><p>This method always returns <code>end()</code> when executed on a JSON type that is not an object.</p><h2id=examples>Examples<aclass=headerlinkhref=#examplestitle="Permanent link">¶</a></h2><detailsclass=example><summary>Example: (1) find object element by key</summary><p>The example shows how <code>find()</code> is used.</p><divclass=highlight><pre><span></span><code><spanclass=cp>#include</span><spanclass=w></span><spanclass=cpf><iostream></span>
<spanclass=w></span><spanclass=n>std</span><spanclass=o>::</span><spanclass=n>cout</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=s>"</span><spanclass=se>\"</span><spanclass=s>two</span><spanclass=se>\"</span><spanclass=s> was found: "</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=p>(</span><spanclass=n>it_two</span><spanclass=w></span><spanclass=o>!=</span><spanclass=w></span><spanclass=n>j_object</span><spanclass=p>.</span><spanclass=n>end</span><spanclass=p>())</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=sc>'\n'</span><spanclass=p>;</span>
<spanclass=w></span><spanclass=n>std</span><spanclass=o>::</span><spanclass=n>cout</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=s>"value at key </span><spanclass=se>\"</span><spanclass=s>two</span><spanclass=se>\"</span><spanclass=s>: "</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=o>*</span><spanclass=n>it_two</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=sc>'\n'</span><spanclass=p>;</span>
<spanclass=w></span><spanclass=n>std</span><spanclass=o>::</span><spanclass=n>cout</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=s>"</span><spanclass=se>\"</span><spanclass=s>three</span><spanclass=se>\"</span><spanclass=s> was found: "</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=p>(</span><spanclass=n>it_three</span><spanclass=w></span><spanclass=o>!=</span><spanclass=w></span><spanclass=n>j_object</span><spanclass=p>.</span><spanclass=n>end</span><spanclass=p>())</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=sc>'\n'</span><spanclass=p>;</span>
</code></pre></div></details><detailsclass=example><summary>Example: (2) find object element by key using string_view</summary><p>The example shows how <code>find()</code> is used.</p><divclass=highlight><pre><span></span><code><spanclass=cp>#include</span><spanclass=w></span><spanclass=cpf><iostream></span>
<spanclass=w></span><spanclass=n>std</span><spanclass=o>::</span><spanclass=n>cout</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=s>"</span><spanclass=se>\"</span><spanclass=s>two</span><spanclass=se>\"</span><spanclass=s> was found: "</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=p>(</span><spanclass=n>it_two</span><spanclass=w></span><spanclass=o>!=</span><spanclass=w></span><spanclass=n>j_object</span><spanclass=p>.</span><spanclass=n>end</span><spanclass=p>())</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=sc>'\n'</span><spanclass=p>;</span>
<spanclass=w></span><spanclass=n>std</span><spanclass=o>::</span><spanclass=n>cout</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=s>"value at key </span><spanclass=se>\"</span><spanclass=s>two</span><spanclass=se>\"</span><spanclass=s>: "</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=o>*</span><spanclass=n>it_two</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=sc>'\n'</span><spanclass=p>;</span>
<spanclass=w></span><spanclass=n>std</span><spanclass=o>::</span><spanclass=n>cout</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=s>"</span><spanclass=se>\"</span><spanclass=s>three</span><spanclass=se>\"</span><spanclass=s> was found: "</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=p>(</span><spanclass=n>it_three</span><spanclass=w></span><spanclass=o>!=</span><spanclass=w></span><spanclass=n>j_object</span><spanclass=p>.</span><spanclass=n>end</span><spanclass=p>())</span><spanclass=w></span><spanclass=o><<</span><spanclass=w></span><spanclass=sc>'\n'</span><spanclass=p>;</span>