std::slice

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

数値ライブラリ

共通の数学関数
数学特殊関数 (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)

 

ヘッダ <valarray> で定義
class slice;

std::slice は、std::valarray のサブセットを識別するためのセレクタクラスです。これは BLAS のスライスに似ています。std::slice 型のオブジェクトは 3 つの値、つまり開始インデックス、ストライド、およびサブセット内の値の総数を保持します。std::slice 型のオブジェクトは、valarray の operator[] でインデックスとして使用できます。

メンバ関数

(コンストラクタ)	スライスを構築します (public member function)
startsizestride	スライスのパラメータを返します (public member function)

std::slice::slice

slice()	(1)
slice( std::size_t start, std::size_t size, std::size_t stride );	(2)
slice( const slice& other );	(3)

新しいスライスを構築します。

1) デフォルトコンストラクタ。slice(0, 0, 0) と同等です。このコンストラクタは、スライスの配列を構築できるようにするためにのみ存在します。

2) パラメータ start、size、stride を持つ新しいスライスを構築します。このスライスは、size 個の要素を参照し、各要素の位置は次のようになります。

start + 0 * stride

start + 1 * stride

...

start + (size - 1) * stride

3) other のコピーを構築します。

パラメータ

start	-	最初の要素の位置
size	-	スライス内の要素数
stride	-	スライス内の連続する要素間の位置数
その他	-	コピーする別のスライス

std::slice::start, size, stride

std::size_t start() const;	(1)
std::size_t size() const;	(2)
std::size_t stride() const;	(3)

スライス構築時に渡されたパラメータ（それぞれ start、size、stride）を返します。

パラメータ

(なし)

戻り値

スライスのパラメータ — それぞれ start、size、stride。

計算量

定数。

非メンバ関数

operator==(std::slice) (C++20)

2 つのスライスが等しいかどうかをチェックします (関数)

operator==(std::slice)

friend bool operator==( const slice& lhs, const slice& rhs );		(C++20以降)

lhs と rhs のパラメータ（start、size、stride）がそれぞれ等しいかどうかをチェックします。

この関数は、通常の 修飾されていない または 修飾された 検索からは見えず、std::slice が引数の関連クラスである場合にのみ 引数依存の名前探索 によって見つけることができます。

!= 演算子は operator== から合成される。

パラメータ

lhs, rhs

-

比較するスライス

戻り値

lhs.start() == rhs.start() && lhs.size() == rhs.size() && lhs.stride() == rhs.stride()

例

トレース計算関数を備えた、ベアボーンの valarray ベースの Matrix クラス。

このコードを実行

#include <iostream>
#include <valarray>
 
class Matrix
{
    std::valarray<int> data;
    int dim;
public:
    Matrix(int r, int c) : data(r*c), dim(c) {}
    int& operator()(int r, int c) { return data[r * dim + c]; }
    int trace() const { return data[std::slice(0, dim, dim + 1)].sum(); }
};
 
int main()
{
    Matrix m(3, 3);
    int n = 0;
    for (int r = 0; r < 3; ++r)
       for (int c = 0; c < 3; ++c)
           m(r, c) = ++n;
    std::cout << "Trace of the matrix (1,2,3) (4,5,6) (7,8,9) is " << m.trace() << '\n';
}

出力

Trace of the matrix (1,2,3) (4,5,6) (7,8,9) is 15

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 543	C++98	デフォルト構築されたスライスが使用可能かどうか不明でした。	使用可能です（空のサブセットとして）。

関連項目

operator[]	valarrayの要素、スライス、またはマスクを取得/設定する (public member function)
gslice	valarrayの汎用スライス: 開始インデックス、長さの集合、ストライドの集合 (class)
slice_array	スライスを適用した後のvalarrayのサブセットへのプロキシ (class template)
mdspan (C++23)	多次元の所有権を持たない配列ビュー (クラステンプレート)