std:: set_difference
|
Определено в заголовке
<algorithm>
|
||
|
template
<
class
InputIt1,
class
InputIt2,
class
OutputIt
>
OutputIt set_difference
(
InputIt1 first1, InputIt1 last1,
|
(1) | (constexpr начиная с C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2,
class
ForwardIt3
>
|
(2) | (начиная с C++17) |
|
template
<
class
InputIt1,
class
InputIt2,
class
OutputIt,
class
Compare
>
|
(3) | (constexpr начиная с C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2,
|
(4) | (начиная с C++17) |
Копирует элементы из отсортированного диапазона
[
first1
,
last1
)
которые отсутствуют в отсортированном диапазоне
[
first2
,
last2
)
в диапазон, начинающийся с
d_first
. Выходной диапазон также является отсортированным.
Если
[
first1
,
last1
)
содержит
m
эквивалентных элементов и
[
first2
,
last2
)
содержит
n
эквивалентных им элементов, то последние
std::
max
(
m
-
n,
0
)
элементов будут скопированы из
[
first1
,
last1
)
в выходной диапазон с сохранением порядка.
[
first1
,
last1
)
или
[
first2
,
last2
)
не является
отсортированным
относительно
operator
<
(до C++20)
std::
less
{
}
(начиная с C++20)
, поведение не определено.
[
first1
,
last1
)
или
[
first2
,
last2
)
не отсортирован относительно
comp
, поведение не определено.
|
std:: is_execution_policy_v < std:: decay_t < ExecutionPolicy >> является true . |
(до C++20) |
|
std:: is_execution_policy_v < std:: remove_cvref_t < ExecutionPolicy >> является true . |
(начиная с C++20) |
Если выходной диапазон пересекается с
[
first1
,
last1
)
или
[
first2
,
last2
)
, поведение не определено.
Содержание |
Параметры
| first1, last1 | - | пара итераторов, определяющая первый входной отсортированный диапазон элементов для исследования |
| first2, last2 | - | пара итераторов, определяющая второй входной отсортированный диапазон элементов для поиска |
| d_first | - | начало выходного диапазона |
| policy | - | политика выполнения для использования |
| comp | - |
функция сравнения (т.е. объект, удовлетворяющий требованиям
Compare
), которая возвращает
true
если первый аргумент
меньше
(т.е. упорядочен
перед
) второго.
Сигнатура функции сравнения должна быть эквивалентна следующей: bool cmp ( const Type1 & a, const Type2 & b ) ;
Хотя сигнатура не обязана содержать
const
&
, функция не должна модифицировать передаваемые ей объекты и должна быть способна принимать все значения типов (возможно const)
|
| Требования к типам | ||
-
InputIt1, InputIt2
должны удовлетворять требованиям
LegacyInputIterator
.
|
||
-
OutputIt
должны удовлетворять требованиям
LegacyOutputIterator
.
|
||
-
ForwardIt1, ForwardIt2, ForwardIt3
должны удовлетворять требованиям
LegacyForwardIterator
.
|
||
-
Compare
должны удовлетворять требованиям
Compare
.
|
||
Возвращаемое значение
Итератор за концом построенного диапазона.
Сложность
Пусть N 1 равно std:: distance ( first1, last1 ) и N 2 равно std:: distance ( first2, last2 ) :
Исключения
Перегрузки с параметром шаблона с именем
ExecutionPolicy
сообщают об ошибках следующим образом:
-
Если выполнение функции, вызванной как часть алгоритма, выбрасывает исключение и
ExecutionPolicyявляется одним из стандартных политик , std::terminate вызывается. Для любой другойExecutionPolicyповедение определяется реализацией. - Если алгоритму не удается выделить память, std::bad_alloc выбрасывается.
Возможная реализация
| set_difference (1) |
|---|
template<class InputIt1, class InputIt2, class OutputIt> OutputIt set_difference(InputIt1 first1, InputIt1 last1, InputIt2 first2, InputIt2 last2, OutputIt d_first) { while (first1 != last1) { if (first2 == last2) return std::copy(first1, last1, d_first); if (*first1 < *first2) *d_first++ = *first1++; else { if (! (*first2 < *first1)) ++first1; ++first2; } } return d_first; } |
| set_difference (3) |
template<class InputIt1, class InputIt2, class OutputIt, class Compare> OutputIt set_difference(InputIt1 first1, InputIt1 last1, InputIt2 first2, InputIt2 last2, OutputIt d_first, Compare comp) { while (first1 != last1) { if (first2 == last2) return std::copy(first1, last1, d_first); if (comp(*first1, *first2)) *d_first++ = *first1++; else { if (!comp(*first2, *first1)) ++first1; ++first2; } } return d_first; } |
Пример
#include <algorithm> #include <iostream> #include <iterator> #include <vector> template<typename T> std::ostream& operator<<(std::ostream& os, const std::vector<T>& v) { os << '{'; for (auto n{v.size()}; const auto& e : v) os << e << (--n ? ", " : ""); return os << '}'; } struct Order // структура с очень интересными данными { int order_id{}; friend std::ostream& operator<<(std::ostream& os, const Order& ord) { return os << ord.order_id; } }; int main() { const std::vector<int> v1{1, 2, 5, 5, 5, 9}; const std::vector<int> v2{2, 5, 7}; std::vector<int> diff; std::set_difference(v1.begin(), v1.end(), v2.begin(), v2.end(), std::inserter(diff, diff.begin())); std::cout << v1 << " ∖ " << v2 << " == " << diff << "\n\n"; // мы хотим узнать, какие заказы "вырезаны" между старым и новым состояниями: std::vector<Order> old_orders{{1}, {2}, {5}, {9}}; std::vector<Order> new_orders{{2}, {5}, {7}}; std::vector<Order> cut_orders; std::set_difference(old_orders.begin(), old_orders.end(), new_orders.begin(), new_orders.end(), std::back_inserter(cut_orders), [](auto& a, auto& b) { return a.order_id < b.order_id; }); std::cout << "old orders: " << old_orders << '\n' << "new orders: " << new_orders << '\n' << "cut orders: " << cut_orders << '\n'; }
Вывод:
{1, 2, 5, 5, 5, 9} ∖ {2, 5, 7} == {1, 5, 5, 9}
old orders: {1, 2, 5, 9}
new orders: {2, 5, 7}
cut orders: {1, 9}
Отчёты о дефектах
Следующие отчеты об изменениях поведения, содержащие исправления дефектов, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 291 | C++98 | не было указано, как обрабатывать эквивалентные элементы во входных диапазонах | указано |
Смотрите также
|
возвращает
true
если одна последовательность является подпоследовательностью другой
(шаблон функции) |
|
|
вычисляет симметрическую разность между двумя множествами
(шаблон функции) |
|
|
(C++20)
|
вычисляет разность между двумя множествами
(функциональный объект алгоритма) |