std::equal

Актуально для C++23.

#include <algorithm>

Актуально на 2024-02-29.

Define overload #1

template<class InputIt1, class InputIt2>
constexpr inline bool
equal(InputIt1 first1, InputIt1 last1, InputIt2 first2);

Сравнивает диапазон [first1, last1] с диапазоном [first2, first2 + std::distance(first1, last1)] на идентичность.
Для сравнения используется оператор ==.
Вернёт true если они эквивалентны, иначе - false.
Example, possible implementation

Define overload #2

template <class ExecutionPolicy, class ForwardIterator1, class ForwardIterator2>
bool equal(ExecutionPolicy&& exec, ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2);

Example, possible implementation

Define overload #3

template<class InputIt1, class InputIt2, class BinaryPredicate>
constexpr inline bool
equal(InputIt1 first1, InputIt1 last1,
	  InputIt2 first2, BinaryPredicate pred)

Сравнивает диапазон [first1, last1] с диапазоном [first2, first2 + std::distance(first1, last1)] на идентичность.
Для сравнения используется бинарный предикат "pred".
Вернёт true если они эквивалентны, иначе - false.
Example, possible implementation

Define overload #4

template <class ExecutionPolicy, class ForwardIterator1,
          class ForwardIterator2, class BinaryPredicate>
bool equal(ExecutionPolicy&& exec, ForwardIterator1 first1, ForwardIterator1 last1,
           ForwardIterator2 first2, BinaryPredicate p);

Example, possible implementation

Define overload #5

template<class InputIt1, class InputIt2>
constexpr inline bool
equal(class InputIt1 first1, class InputIt1 last1, InputIt2 first2, InputIt2 last2)

Сравнивает диапазон [first1, last1] с диапазоном [first2, last2] на идентичность.
Для сравнения используется оператор ==.
Вернёт true если они эквивалентны, иначе - false.
Example, possible implementation

Define overload #6

template <class ExecutionPolicy, class ForwardIterator1, class ForwardIterator2>
bool equal(ExecutionPolicy&& exec, ForwardIterator1 first1, ForwardIterator1 last1,
           ForwardIterator2 first2, ForwardIterator2 last2);

Example, possible implementation

Define overload #7

template<class InputIt1, class InputIt2, class BinaryPredicate>
constexpr inline bool
equal(InputIt1 first1, InputIt1 last1,
	  InputIt2 first2, InputIt2 last2, BinaryPredicate pred)

Сравнивает диапазон [first1, last1] с диапазоном [first2, last2] на идентичность.
Для сравнения используется бинарный предикат "pred".
Вернёт true если они эквивалентны, иначе - false.
Example, possible implementation

Define overload #8

template <class ExecutionPolicy, class ForwardIterator1,
          class ForwardIterator2, class BinaryPredicate>
bool equal(ExecutionPolicy&& exec, ForwardIterator1 first1, ForwardIterator1 last1,
           ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate p);

Example, possible implementation

Examples

Example 1:

#include <iostream>
#include <algorithm>
#include <string>

int main()
{
    std::string str1{"aabccdedfff"};
    std::string str2{"aabccdedfff"};
    auto end = std::equal(std::begin(str1), std::end(str1), std::begin(str2));
    if (end)
    {
        std::cout << "range is equivalent" << std::endl;
    }
    else
    {
        std::cout << "range is not equivalent" << std::endl;
    }
    return 0;
}

range is equivalent

Example 2:

#include <iostream>
#include <algorithm>
#include <string>

int main()
{
    auto pred = [](auto a1, auto a2) {
        return a1 == a2;
    };

    std::string str1{"aabccdedfff"};
    std::string str2{"aabccdedff"};
    auto end = std::equal(std::begin(str1), std::end(str1),
                          std::begin(str2), pred);
    if (end)
    {
        std::cout << "range is equivalent" << std::endl;
    }
    else
    {
        std::cout << "range is not equivalent" << std::endl;
    }
    return 0;
}

range is not equivalent

Changelog

See also

TODO

This page was last modified on 2024-02-29