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 аналогично срезу в BLAS . Объект типа std::slice содержит три значения: начальный индекс, шаг и общее количество элементов в подмножестве. Объекты типа std::slice могут использоваться в качестве индексов с operator [ ] valarray.

Содержание

Функции-члены

(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)

Создает новый срез.

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 - количество позиций между последовательными элементами в срезе
other - другой срез для копирования

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 - start, size и stride соответственно.

Эта функция не видна при обычном неквалифицированном поиске или квалифицированном поиске , и может быть найдена только с помощью поиска, зависимого от аргументов , когда std::slice является ассоциированным классом аргументов.

Оператор != синтезируется из operator== .

Параметры

lhs, rhs - сравниваемые срезы

Возвращаемое значение

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

Пример

Простой класс Matrix на основе 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++.

DR Applied to Behavior as published Correct behavior
LWG 543 C++98 it was unclear whether a default constructed slice is usable it is usable (as an empty subset)

Смотрите также

получение/установка элемента valarray, среза или маски
(публичная функция-член)
обобщённый срез valarray: начальный индекс, набор длин, набор шагов
(класс)
прокси для подмножества valarray после применения среза
(шаблон класса)
(C++23)
многомерное представление массива без владения
(шаблон класса)