C++11

// <numeric> 
template< class ForwardIterator, class T >
    void iota( ForwardIterator first,
​        ForwardIterator last, T value );

用顺序递增的值赋值指定范围内的元素 。

该函数等价于:

template<class _FwdIt,
class _Ty> inline
    void _Iota(_FwdIt _First, _FwdIt _Last, _Ty _Val)
{	// compute increasing sequence into [_First, _Last)
    for (; _First != _Last; ++_First, ++_Val)
        *_First = _Val;
}
  • firstlast

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

    val

    用于累加的初始值。

  • 无。

  • 例 1

    #include <iostream>
    #include <numeric>
    #include <iterator>
    #include <vector>
    
    namespace ClassFoo{
        void Iota_1() {
            // 构造一个 vector 对象
            std::vector<int> foo;
            foo.resize(15);
            // 将从 9 开始的 15 次递增值赋值给 foo
            std::iota(foo.begin(), foo.end(), 9);
            // 输出 foo 中的内容
            std::copy(
                foo.begin(),
                foo.end(),
                std::ostream_iterator<int>(std::cout, " "));
            std::cout << std::endl;
        }
    }
    int main()
    {
        ClassFoo::Iota_1();
        return 0;
    }

    9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 

  • 复杂度

    O(N)N 等值于 std::distance(first,last)

    数据争用相关

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

    异常安全性相关

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

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