| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Wed, 30 Jul 2025 13:11:50 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/set/set/find/
HTTP/1.1 200 OK
Server: nginx
Date: Wed, 30 Jul 2025 13:11:50 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"7853-RBXNhqK8wbVh2l+NBqa2nTM0YsE"
Content-Encoding: gzip
Searches the container for an element equivalent to val and returns an iterator to it if found, otherwise it returns an iterator to set::end.
Two elements of a set are considered equivalent if the container's comparison object returns false reflexively (i.e., no matter the order in which the elements are passed as arguments).
Member types iterator and const_iterator are bidirectional iterator types pointing to elements.
Output:
Concurrently accessing the elements of a set is safe.
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
set
- set::~set
- set::set
member functions
- set::begin
-
set::cbeginC++11
-
set::cendC++11
- set::clear
- set::count
-
set::crbeginC++11
-
set::crendC++11
-
set::emplaceC++11
-
set::emplace_hintC++11
- set::empty
- set::end
- set::equal_range
- set::erase
- set::find
- set::get_allocator
- set::insert
- set::key_comp
- set::lower_bound
- set::max_size
- set::operator=
- set::rbegin
- set::rend
- set::size
- set::swap
- set::upper_bound
- set::value_comp
non-member overloads
public member function
<set>
std::set::find
iterator find (const value_type& val) const;
const_iterator find (const value_type& val) const;iterator find (const value_type& val);
Get iterator to element
Two elements of a set are considered equivalent if the container's comparison object returns false reflexively (i.e., no matter the order in which the elements are passed as arguments).
Parameters
- val
- Value to be searched for.
Member type value_type is the type of the elements in the container, defined in set as an alias of its first template parameter (T).
Return value
An iterator to the element, if val is found, or set::end otherwise.Member types iterator and const_iterator are bidirectional iterator types pointing to elements.
Example
|
|
Output:
myset contains: 10 30 50 |
Complexity
Logarithmic in size.Iterator validity
No changes.Data races
The container is accessed (neither the const nor the non-const versions modify the container).Concurrently accessing the elements of a set is safe.
Exception safety
Strong guarantee: if an exception is thrown, there are no changes in the container.See also
- set::count
- Count elements with a specific value (public member function)
- set::lower_bound
- Return iterator to lower bound (public member function)
- set::upper_bound
- Return iterator to upper bound (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us