// <algorithm> 
// 等价比较(1)    
template <class InputIterator1,
    class InputIterator2>
    pair<InputIterator1, InputIterator2>
    mismatch (InputIterator1 first1,
              InputIterator1 last1,
              InputIterator2 first2);
// 自定义谓词比较(2)
template <class InputIterator1,
    class InputIterator2,
    class BinaryPredicate>
    pair<InputIterator1, InputIterator2>
    mismatch (InputIterator1 first1,
              InputIterator1 last1,
              InputIterator2 first2,
              BinaryPredicate pred);

返回两个范围中第一个元素不等价的位置。

该函数等价于:

template<class _InIt1,
    class _InIt2,
    class _Pr> inline
    pair<_InIt1, _InIt2>
        _Mismatch(_InIt1 _First1, _InIt1 _Last1,
            _InIt2 _First2, _Pr _Pred)
    {    // return [_First1, _Last1)/[_First2, ...) mismatch using _Pred
        for (; _First1 != _Last1 && _Pred(*_First1, *_First2); )
            ++_First1, ++_First2;
        return (pair<_InIt1, _InIt2>(_First1, _First2));
    }
  • first1last1

    分别指向一个序列中初始及末尾位置的输入迭代器(Input iterators)。这个范围即 [first1,last1) ,包括 first1 到 last1 间的所有元素,包括 first1 指向的元素,但不包括 last1 指向的元素。

    first2

    指向第二个序列中初始位置的输入迭代器(Input iterators)。当前函数最多访问与范围 [first1,last1)  中相同元素个数的元素。

    pred

    二元谓词(Binary)函数,以两个元素为参数,然后返回一个可转换成 bool 类型的值。

    其返回值表明指定两个元素是否满足当前函数所检测的匹配条件。

    该函数不能修改其参数。

    可以是函数指针(Function pointer)类型或函数对象(Function object)类型。

    返回

    返回一个 std::pair 对象,其成员 firstsecond 分别指向两个序列中第一次出现的两个对应不匹配的元素。

    如果所有元素都匹配,当前函数返回的 std::pair 对象的 first 成员值为 last1second 成员值为指向第二序列中相同偏移位置处的元素的迭代器。

  • 例 1

    #include <iostream>
    #include <algorithm>
    #include <vector>
    
    #define CLASSFOO_VECTOR(type, name, ...) \
    static const type name##_a[] = __VA_ARGS__; \
    std::vector<type> name(name##_a, name##_a + sizeof(name##_a) / sizeof(*name##_a))
    
    namespace ClassFoo{
        bool IfEqual(int m, int n) {
            return (m == n);
        }
        void Mismatch_1() {
            CLASSFOO_VECTOR(int, BigVector, { 8, 23, 5, 6, 7, 29, 0, 5, 6, 7, 1, 1 });
            CLASSFOO_VECTOR(int, SmallVector, { 8, 23, 5, 6, 3, 29, 0, 13, 6, 7, 1, 0 });
            // 等价比较
            std::pair<std::vector<int>::iterator, std::vector<int>::iterator> p = std::mismatch(
                std::begin(BigVector),
                std::end(BigVector),
                std::begin(SmallVector));
            if (p.first != std::end(BigVector)) {
                std::cout << "找到: " << *p.first << '\n';
                std::cout << "前一个元素是: " << *(p.first - 1) << '\n';
            }
            // 自定谓词比较
            p = std::mismatch(
                std::begin(BigVector),
                std::end(BigVector),
                std::begin(SmallVector),
                IfEqual);
            if (p.first != std::end(BigVector)) {
                std::cout << "找到: " << *p.first << '\n';
                std::cout << "前一个元素是: " << *(p.first - 1) << '\n';
            }
        }
    }
    int main()
    {
        ClassFoo::Mismatch_1();
        return 0;
    }

    找到: 7
    前一个元素是: 6
    找到: 7
    前一个元素是: 6

    例 2

    C++11

    #include <iostream>
    #include <algorithm>
    #include <vector>
    
    namespace ClassFoo{
        void Mismatch_2() {
            std::vector<int> BigVector = { 8, 23, 5, 6, 7, 29, 0, 5, 6, 7, 1, 1 };
            std::vector<int> SmallVector = { 8, 23, 5, 6, 3, 29, 0, 13, 6, 7, 1, 0 };
            // 等价比较
            auto p = std::mismatch(
                std::begin(BigVector),
                std::end(BigVector),
                std::begin(SmallVector));
            if (p.first != std::end(BigVector)) {
                std::cout << "找到: " << *p.first << '\n';
                std::cout << "前一个元素是: " << *(p.first - 1) << '\n';
            }
            // 自定谓词比较
            p = std::mismatch(
                std::begin(BigVector),
                std::end(BigVector),
                std::begin(SmallVector),
                [](int &m, int &n) { return m == n; });
            if (p.first != std::end(BigVector)) {
                std::cout << "找到: " << *p.first << '\n';
                std::cout << "前一个元素是: " << *(p.first - 1) << '\n';
            }
        }
    }
    int main()
    {
        ClassFoo::Mismatch_2();
        return 0;
    }

    找到: 7
    前一个元素是: 6
    找到: 7
    前一个元素是: 6

  • 复杂度

    O(n)n 为 last first,比较所有元素,直到发现匹配。

    数据争用相关

    访问两个序列中的部份(或所有)元素,且每个元素确定只被访问一次。

    异常安全性相关

    如果元素比较(or pred) 或操作某个迭代器抛异常,该函数才会抛异常。

    注意 无效参数将导致未定义行为(Undefined behavior)