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

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

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

Ввод / вывод

Локализация

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

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

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

 

Алгоритмы

Функции
Немодифицирующие линейные операции
all_of any_of none_of (C++11) (C++11) (C++11) for_each count count_if mismatch equal	find find_if find_if_not (C++11) find_end find_first_of adjacent_find search search_n
Модифицирующие линейные операции
copy copy_if (C++11) copy_n (C++11) copy_backward move (C++11) move_backward (C++11) fill fill_n transform generate generate_n remove remove_if remove_copy remove_copy_if	replace replace_if replace_copy replace_copy_if swap swap_ranges iter_swap reverse reverse_copy rotate rotate_copy random_shuffle shuffle   (C++11) unique unique_copy
Разделение
is_partitioned (C++11) partition partition_copy (C++11)	stable_partition partition_point (C++11)
Сортировка (на отсортированных промежутках)
is_sorted (C++11) is_sorted_until (C++11) 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 (C++11) make_heap	push_heap pop_heap sort_heap
Минимум/максимум
max max_element min min_element minmax (C++11) minmax_element (C++11)	lexicographical_compare is_permutation (C++11) next_permutation prev_permutation
Числовые операции
iota (C++11) accumulate inner_product	adjacent_difference partial_sum
Библиотека C
qsort	bsearch

 

Определено в заголовочном файле <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	Ищет первое вхождение последовательности элементов в диапазон (шаблон функции)