std::begin(std::valarray)

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

數值庫

常用數學函式
數學特殊函式 (C++17)
數學常數 (C++20)
基本線性代數演算法 (C++26)
資料並行型別 (SIMD) (C++26)
浮點環境 (C++11)
複數
數值陣列 (valarray)
偽隨機數生成
位操作 (C++20)
因子運算
gcd (C++17)	lcm (C++17)
插值
midpoint (C++20)	lerp (C++20)
飽和算術
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
通用數值運算
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

std::valarray

成員函式
valarray::valarray valarray::~valarray valarray::operator= valarray::operator[] valarray::swap valarray::size valarray::resize valarray::sum valarray::min valarray::max valarray::shift valarray::cshift valarray::apply	valarray::operator+valarray::operator-valarray::operator~valarray::operator! valarray::operator+=valarray::operator-=valarray::operator*=valarray::operator/=valarray::operator%=valarray::operator&=valarray::operator|=valarray::operator^=valarray::operator<<=valarray::operator>>=
非成員函式
swap(std::valarray) (C++11) begin(std::valarray) (C++11)   end(std::valarray) (C++11) abs exp log log10 pow sqrt sin cos tan asin acos atan atan2 sinh cosh tanh	operator*operator/operator%operator+operator-operator^operator&operator|operator<<operator>>operator&&operator|| operator==operator!=operator<operator>operator<=operator>=
輔助類
slice_array gslice_array indirect_array	slice gslice mask_array
推導指南 (C++17 起)

 

template< class T > /* 見下文 */ begin( valarray<T>& v );	(1)	(C++11 起)
template< class T > /* 見下文 */ begin( const valarray<T>& v );	(2)	(C++11 起)

valarray 的 std::begin 過載返回一個未指定型別的迭代器，它指向數值陣列中的第一個元素。

1) 返回型別必須

• 滿足可變 LegacyRandomAccessIterator 的要求，

模型 contiguous_iterator，

(C++20 起)

• 具有成員型別 value_type，其為 T，以及
• 具有成員型別 reference，其為 T&。

2) 返回型別必須

• 滿足常量 LegacyRandomAccessIterator 的要求，

模型 contiguous_iterator，

(C++20 起)

• 具有成員型別 value_type，其為 T，以及
• 具有成員型別 reference，其為 const T&。

當在 v 上呼叫成員函式 resize() 或 v 的生命週期結束時（以先發生者為準），從此函式返回的迭代器將失效。

引數

v

-

一個數值陣列

返回值

指向數值陣列中第一個值的迭代器。

異常

可能丟擲實現定義的異常。

注意

與其他接受 std::valarray 引數的函式不同，begin() 不能接受由涉及 valarrays 的表示式可能返回的替換型別（例如由表示式模板生成的型別）：std::begin(v1 + v2) 不可移植，而必須使用 std::begin(std::valarray<T>(v1 + v2))。

此函式的目的是允許 範圍 for 迴圈與 valarrays 一起工作，而不是提供容器語義。

示例

執行此程式碼

#include <algorithm>
#include <iostream>
#include <valarray>
 
void show(const std::valarray<int>& v)
{
    std::for_each(std::begin(v), std::end(v), [](int c)
    {
        std::cout << c << ' ';
    });
    std::cout << '\n';
};
 
int main()
{
    const std::valarray<int> x{47, 70, 37, 52, 90, 23, 17, 33, 22, 16, 21, 4};
    const std::valarray<int> y{25, 31, 71, 56, 21, 21, 15, 34, 21, 27, 12, 6};
 
    show(x); 
    show(y); 
 
    const std::valarray<int> z{x + y};
 
    for (char c : z)
        std::cout << c;
}

輸出

47 70 37 52 90 23 17 33 22 16 21 4 
25 31 71 56 21 21 15 34 21 27 12 6 
Hello, C++!

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 2058	C++11	1. begin() 被要求支援替換型別 2. 返回的迭代器何時失效未指定	1. 不再要求 2. 已指定

另請參閱

std::end(std::valarray) (C++11)

特化 std::end (函式模板)