Namespaces
Variants

std:: slice

From cppreference.net
C++
Numerics library
std::valarray
Member functions
Non-member functions
Helper classes
Deduction guides (C++17)
定义于头文件 <valarray>
class slice ;

std::slice 是用于选取 std::valarray 子集的 selector 类，其功能类似于 BLAS 切片。 std::slice 类型的对象包含三个值：起始索引、步长和子集中值的总数。 std::slice 类型的对象可用作 valarray 的 operator [ ] 的索引。

目录

成员函数

(constructor)
构造切片
(公开成员函数)
start size stride
返回切片的参数
(公开成员函数)

std::slice:: slice

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

构造一个新的 slice。

1) 默认构造函数。等价于 slice ( 0 , 0 , 0 ) 。此构造函数仅用于允许构造 slice 数组。
2) 使用参数 start 、 size 、 stride 构造新的 slice。该 slice 将引用 size 个元素，每个元素的位置为：
start + 0 * stride
start + 1 * stride
...
start + (size - 1) * stride
3) 构造 other 的副本。

参数

start - 第一个元素的位置
size - slice 中的元素数量
stride - slice 中连续元素之间的位置间隔数
other - 要复制的另一个 slice

std::slice:: start, size, stride

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

返回构造切片时传入的参数——分别是起始位置、大小和步长。

参数

（无）

返回值

切片的参数——分别是起始位置、大小和步长。

复杂度

常数时间。

非成员函数

operator== (std::slice)
(C++20)
检查两个切片是否相等
(函数)

operator== (std::slice)

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

检查 lhs 和 rhs 的参数——起始位置、大小和步长是否分别相等。

此函数对普通的 非限定查找 或 限定查找 不可见，仅当 std::slice 是参数的关联类时，才能通过 实参依赖查找 找到。

!= 运算符由 operator== 合成 。

参数

lhs, rhs - 要比较的切片

返回值

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

示例

基于 valarray 的简易矩阵类，包含 迹 计算功能。

运行此代码 
#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++标准。

缺陷报告 应用于 发布时的行为 正确行为
LWG 543 C++98 未明确说明默认构造的slice是否可用 明确其可用（作为空子集）

参见

获取/设置 valarray 元素、切片或掩码
(公开成员函数)
valarray 的广义切片：起始索引、长度集合、步幅集合
(类)
应用切片后 valarray 子集的代理
(类模板)
(C++23)
多维非拥有数组视图
(类模板)