std::find, std::find_if, std::find_if_not

 

C++

Язык

Заголовочные файлы

Концепты

Поддержка языка

Ошибка

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод/вывод

Локализация

Регулярные выражения (C++11)

Атомарные операции (C++11)

Потоки (C++11)

Файловая система (C++17)

Технические спецификации

 

Алгоритмы

Функции
Немодифицирующие линейные операции
all_ofany_ofnone_of Шаблон:lines for_each countcount_if mismatch equal	findfind_iffind_if_not Шаблон:lines find_end find_first_of adjacent_find search search_n
Модифицирующие линейные операции
copycopy_if Шаблон:lines copy_n Шаблон:lines copy_backward move Шаблон:lines move_backward Шаблон:lines fill fill_n transform generate generate_n removeremove_if remove_copyremove_copy_if	replacereplace_if replace_copyreplace_copy_if swap swap_ranges iter_swap reverse reverse_copy rotate rotate_copy random_shuffleshuffle Шаблон:lines unique unique_copy
Разделение
is_partitioned Шаблон:lines partition partition_copy Шаблон:lines	stable_partition partition_point Шаблон:lines
Сортировка (на отсортированных промежутках)
is_sorted Шаблон:lines is_sorted_until Шаблон:lines sort	partial_sort partial_sort_copy stable_sort nth_element
Бинарный поиск (на отсортированных промежутках)
lower_bound upper_bound	binary_search equal_range
Множества (на отсортированных промежутках)
merge inplace_merge includes	set_difference set_intersection set_symmetric_difference set_union
Куча
is_heap is_heap_until Шаблон:lines make_heap	push_heap pop_heap sort_heap
Минимум/максимум
max max_element min min_element minmax Шаблон:lines minmax_element Шаблон:lines	lexicographical_compare is_permutation Шаблон:lines next_permutation prev_permutation
Числовые операции
iota Шаблон:lines accumulate inner_product	adjacent_difference partial_sum
Библиотека C
qsort	bsearch

 

Defined in header <algorithm>
template< class InputIt, class T > InputIt find( InputIt first, InputIt last, const T& value );	(1)
template< class InputIt, class UnaryPredicate > InputIt find_if( InputIt first, InputIt last,                  UnaryPredicate p );	(2)
template< class InputIt, class UnaryPredicate > InputIt find_if_not( InputIt first, InputIt last,                      UnaryPredicate q );	(3)	(начиная с C++11)

Эти функции находят в диапазоне [first, last) первый элемент, удовлетворяющий определённым условиям:

1. find ищет элемент, равный value

2. find_if ищет элемент, для которого предикат p возвращает значение true

3. find_if_not ищет элемент, для которого предикат q возвращает значение false

Параметры

first, last	—	диапазон элементов для проверки
value	—	значение для сравнения с ним элементов
p	—	унарный предикат, который возвращает​true для искомого элемента. Определение функции предиката должно быть эквивалентно следующему:  bool pred(const Type &a); Присутствие const & в определении не обязательно, но функция не должна модифицировать передаваемые ей объекты. Тип Type должен быть таков, что объект типа InputIt может быть разыменован и затем неявно преобразован в Type. ​
q	—	унарный предикат, который возвращает​false для искомого элемента. Определение функции предиката должно быть эквивалентно следующему:  bool pred(const Type &a); Присутствие const & в определении не обязательно, но функция не должна модифицировать передаваемые ей объекты. Тип Type должен быть таков, что объект типа InputIt может быть разыменован и затем неявно преобразован в Type. ​
Требования к типам
- InputIt должен соответствовать требованиям InputIterator.

Возвращаемое значение

Итератор на первый элемент, удовлетворяющий условию, или last, если такой элемент не найден.

Сложность

Не больше last - first применений предиката.

Возможная реализация

Первый вариант
template<class InputIt, class T> InputIt find(InputIt first, InputIt last, const T& value) { for (; first != last; ++first) { if (*first == value) { return first; } } return last; }
Второй вариант
template<class InputIt, class UnaryPredicate> InputIt find_if(InputIt first, InputIt last, UnaryPredicate p) { for (; first != last; ++first) { if (p(*first)) { return first; } } return last; }
Третий вариант
template<class InputIt, class UnaryPredicate> InputIt find_if_not(InputIt first, InputIt last, UnaryPredicate q) { for (; first != last; ++first) { if (!q(*first)) { return first; } } return last; }

Если у вас нет C++11, то эквивалентом std::find_if_not является std::find_if с отрицанием предиката.

template<class InputIt, class UnaryPredicate> InputIt find_if_not(InputIt first, InputIt last, UnaryPredicate q) { return std::find_if(first, last, std::not1(q)); }

Пример

В следующем примере в векторе целых чисел ищется заданное.

Запустить этот код

#include <iostream>
#include <algorithm>
#include <vector>
 
int main()
{
    int n1 = 3;
    int n2 = 5;
 
    std::vector<int> v{0, 1, 2, 3, 4};
 
    auto result1 = std::find(v.begin(), v.end(), n1);
    auto result2 = std::find(v.begin(), v.end(), n2);
 
    if (result1 != v.end()) {
        std::cout << "v содержит: " << n1 << '\n';
    } else {
        std::cout << "v не содержит: " << n1 << '\n';
    }
 
    if (result2 != v.end()) {
        std::cout << "v содержит: " << n2 << '\n';
    } else {
        std::cout << "v не содержит: " << n2 << '\n';
    }
}

Вывод:

v содержит: 3
v не содержит: 5

См. также

adjacent_find	Ищет в диапазоне два одинаковых смежных элемента (шаблон функции)
find_end	Ищет последнее вхождение подпоследовательности элементов в диапазон (шаблон функции)
find_first_of	Ищет в множестве элементов первое вхождение любого элемента другого множества (шаблон функции)
mismatch	Находит первую позицию, в которой два диапазона отличаются (шаблон функции)
search	Ищет первое вхождение последовательности элементов в диапазон (шаблон функции)