// <algorithm> 
template <class InputIterator, class T>
    InputIterator find (InputIterator first,
                        InputIterator last,
​                        const T& val);

返回第一个值等价于给定值的元素。

该函数等价于:

template<class _InIt,
    class _Ty> inline
    _InIt _Find(_InIt _First, _InIt _Last, const _Ty& _Val, false_type)
    {    // find first matching _Val
        for (; _First != _Last; ++_First)
            if (*_First == _Val)
                break;
        return (_First);
    }
  • firstlast

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

    val

    需要被搜索的值。

    返回

    返回指向范围中与 val 等值的第一个元素的迭代器。

    如果没有元素匹配,则返回 last 迭代器。

  • 例 1

    #include <iostream>
    #include <algorithm>
    #include <functional>
    #include <vector>
    // 用在此处是为了方便简洁, 在实际编程中慎用
    using namespace std;
    int main()
    {
        int iarray[] = { 0, 1, 2, 3, 4, 5, 6, 4, 6, 7, 8 };
        vector<int> foo1(iarray, iarray + sizeof(iarray) / sizeof(int));
        //找出foo1之中元素值为4的第一个元素,并打印其值
        cout << *find(foo1.begin(), foo1.end(), 4) << endl;
        return 0;
    }

    4

    例 2

    C++11

    #include <iostream>
    #include <algorithm>
    #include <vector>
    #include <iterator>
    
    int main()
    {
        std::vector<int> v{ 0, 1, 2, 3, 4 };
    
        auto it = std::find(std::begin(v), std::end(v), 3);
    
        if (it != std::end(v)) {
            std::cout << "I find it." << '\n';
        }
        return 0;
    }

    I find it.

  • 复杂度

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

    数据争用相关

    访问在范围 [first,last) 中的部份(或所有)元素,且每个元素确定只被访问一次。

    异常安全性相关

    如果 fn 或操作某个迭代器抛异常,该函数才会抛异常。

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