命名空间
变体
操作

std::experimental::ranges::mismatch

来自 cppreference.com
< cpp‎ | experimental‎ | ranges
 
 
实验性
技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
库基础 3 (库基础 TS v3)
并行扩展 (并行 TS)
并行扩展 2 (并行 TS v2)
并发扩展 (并发 TS)
并发扩展 2 (并发 TS v2)
概念 (概念 TS)
范围 (范围 TS)
反射 (反射 TS)
数学特殊函数 (特殊函数 TR)
实验性非 TS
模式匹配
线性代数
std::execution
契约
2D 图形
 
 
 
定义在头文件 <experimental/ranges/algorithm>
template< InputIterator I1, Sentinel<I1> S1, InputIterator I2, Sentinel<I2> S2,

          class Proj1 = ranges::identity, class Proj2 = ranges::identity,
          class Pred = ranges::equal_to<> >
    requires IndirectRelation<Pred, projected<I1, Proj1>, projected<I2, Proj2>>
auto mismatch( I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{},
               Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} )

    -> ranges::tagged_pair<tag::in1(I1), tag::in2(I2)>;
(1) (范围 TS)
template< InputRange R1, InputRange R2,

          class Proj1 = ranges::identity, class Proj2 = ranges::identity,
          class Pred = ranges::equal_to<> >
    requires IndirectRelation<Pred, projected<ranges::iterator_t<R1>, Proj1>,
                              projected<ranges::iterator_t<R2>, Proj2>>
auto mismatch( R1&& r1, R2&& r2, Pred pred = Pred{},
               Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} )
    -> ranges::tagged_pair<tag::in1(ranges::safe_iterator_t<R1>),

                           tag::in2(ranges::safe_iterator_t<R2>)>;
(2) (范围 TS)
template< InputIterator I1, Sentinel<I1> S1, class I2,

          class Pred  = ranges::equal_to<>,
          class Proj1 = ranges::identity, class Proj2 = ranges::identity >
    requires InputIterator<std::decay_t<I2>> && !Range<I2> &&
             IndirectRelation<Pred, projected<I1, Proj1>,
                                    projected<std::decay_t<I2>, Proj2>>
auto mismatch( I1 first1, S1 last1, I2&& first2_, Pred pred = Pred{},
               Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} )

    -> ranges::tagged_pair<tag::in1(I1), tag::in2(std::decay_t<I2>)>;
(3) (范围 TS)
(已弃用)
template< InputRange R1, class I2, class Pred = ranges::equal_to<>,

          class Proj1 = ranges::identity, class Proj2 = ranges::identity >
    requires InputIterator<std::decay_t<I2>> && !Range<I2> &&
             IndirectRelation<Pred, projected<ranges::iterator_t<R1>, Proj1>,
                                    projected<std::decay_t<I2>, Proj2>>
auto mismatch( R1&& r1, I2&& first2_, Pred pred = Pred{},
               Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} )
    -> ranges::tagged_pair<tag::in1(ranges::safe_iterator_t<Rng1>),

                           tag::in2(std::decay_t<I2>)>;
(4) (范围 TS)
(已弃用)
1) 返回两个范围中第一个不匹配的元素对:一个由 `[`first1last1) 定义,另一个由 `[`first2last2) 定义。
2)(1) 相同,但使用 r1 作为第一个源范围,r2 作为第二个源范围,就像使用 ranges::begin(r1) 作为 first1ranges::end(r1) 作为 last1ranges::begin(r2) 作为 first2ranges::end(r2) 作为 last2
3)(1) 相同,但行为就像 first2std::decay_t<I2> first2 = std::forward<I2>(first2_); 并且 last2ranges::unreachable{}. 底层算法从未将 first2 增加超过 last1 - first1 次。
4)(3) 相同,但使用 r1 作为第一个源范围,就像使用 ranges::begin(r1) 作为 first1 并且 ranges::end(r1) 作为 last1

元素使用 pred 与两个范围的投影元素进行比较,就像通过 ranges::invoke(pred, ranges::invoke(proj1, *i), ranges::invoke(proj2, *j)) 进行比较。

尽管有以上描述,但算法声明的实际模板参数数量和顺序是未指定的。因此,如果在调用算法时使用显式模板参数,程序可能不可移植。

内容

[编辑] 参数

first1, last1 - 元素的第一个范围
r1 - 元素的第一个范围
first2, last2 - 元素的第二个范围
r2 - 元素的第二个范围
first2_ - 元素的第二个范围的起点
pred - 应用于投影元素的谓词
proj1 - 应用于第一个范围中元素的投影
proj2 - 应用于第二个范围中元素的投影

[编辑] 返回值

一个 `tagged_pair` 对象,包含指向第一个两个不相等元素的迭代器(来自第一个范围的迭代器带有标签 in1,来自第二个范围的迭代器带有标签 in2)。

如果在比较到达 last1last2 时没有找到不匹配项,则无论哪一个先发生,该对都包含结束迭代器和来自另一个范围的相应迭代器。

[编辑] 复杂度

最多 last1 - first1 次谓词应用和每个投影应用。

[编辑] 可能的实现

template<InputIterator I1, Sentinel<I1> S1, InputIterator I2, Sentinel<I2> S2,
         class Proj1 = ranges::identity, class Proj2 = ranges::identity,
         class Pred = ranges::equal_to<>>
    requires IndirectRelation<Pred, projected<I1, Proj1>, projected<I2, Proj2>>
auto mismatch(I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{},
              Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{})
    -> ranges::tagged_pair<tag::in1(I1), tag::in2(I2)>
{
    while (first1 != last1 && first2 != last2 &&
           ranges::invoke(pred, ranges::invoke(proj1, *first1),
                                ranges::invoke(proj2, *first2)))
    {
        ++first1;
        ++first2;
    }
    return {first1, first2};
}

[编辑] 示例

[编辑] 另请参阅

找到两个范围不同的第一个位置
(函数模板) [编辑]
确定两组元素是否相同
(函数模板) [编辑]
找到第一个满足特定条件的元素
(函数模板) [编辑]
如果一个范围在字典序上小于另一个范围,则返回 true
(函数模板) [编辑]
搜索一个元素范围
(函数模板) [编辑]