std::gslice

Определён в заголовочном файле `<valarray>`
class gslice;

std::gslice — это класс-селектор, задающий подмножество индексов std::valarray, определяемое многоуровневым набором шагов и размеров. Объекты типа std::gslice можно использовать в качестве индексов с operator[] класса valarray для выбора, например, столбцов многомерного массива, представленного в виде valarray.

Для начального значения s, списка шагов i_j и списка размеров d_j объект std::gslice, созданный на основе этих значений, выбирает набор индексов k_j=s+Σ_j(i_jd_j).

Например, gslice с начальным индексом 3, шагами {19,4,1} и длинами {2,4,3} создаёт следующий набор индексов 24=2*4*3:

3+0*19+0*4+0*1=3, 3+0*19+0*4+1*1=4, 3+0*19+0*4+2*1=5, 3+0*19+1*4+0*1=7, 3+0*19+1*4+1*1=8, 3+0*19+1*4+2*1=9, 3+0*19+2*4+0*1=11, ... 3+1*19+3*4+1*1=35, 3+1*19+3*4+2*1=36

Можно создать объекты std::gslice, которые выбирают некоторые индексы более одного раза: если бы в приведённом примере использовались шаги {1,1,1}, индексы имели бы вид {3, 4, 5, 4, 5, 6, ...}. Такие объекты gslice можно использовать только в качестве аргументов константной версии std::valarray::operator[]; в противном случае поведение не определено.

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

(constructor)	создаёт обобщённый срез (открытая функция-член)
startsizestride	возвращает параметры среза (открытая функция-член)

std::gslice::gslice

gslice()	(1)
gslice( std::size_t start, const std::valarray<std::size_t>& sizes, const std::valarray<std::size_t>& strides );	(2)
gslice( const gslice& other );	(3)

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

1) Конструктор по умолчанию. Эквивалентен gslice(0, std::valarray<std::size_t>(), std::valarray<std::size_t>()). Этот конструктор существует только для возможности создания массивов срезов.

2) Создаёт новый срез с параметрами start, sizes, strides.

3) Создаёт копию other.

Параметры

start	-	позиция первого элемента
sizes	-	массив, задающий количество элементов в каждом измерении
strides	-	массив, задающий количество позиций между последовательными элементами в каждом измерении
other	-	другой срез для копирования

std::slice::start, size, stride

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

Возвращает параметры, переданные срезу при создании, — соответственно начальное значение, размеры и шаги.

Параметры

Отсутствуют

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

Параметры среза — соответственно начальное значение, размеры и шаги.

Сложность

Константная.

Пример

Демонстрирует использование gslice для обращения к столбцам трёхмерного массива:

#include <iostream>
#include <valarray>

void test_print(std::valarray<int>& v, int planes, int rows, int cols)
{
    for (int r = 0; r < rows; ++r)
    {
        for (int z = 0; z < planes; ++z)
        {
            for (int c = 0; c < cols; ++c)
                std::cout << v[z * rows * cols + r * cols + c] << ' ';
            std::cout << "  ";
        }
        std::cout << '\n';
    }
}

int main()
{
    std::valarray<int> v = // 3d array: 2 x 4 x 3 elements
        {111,112,113 , 121,122,123 , 131,132,133 , 141,142,143,
         211,212,213 , 221,222,223 , 231,232,233 , 241,242,243};
    // int ar3d[2][4][3]
    std::cout << "Initial 2x4x3 array:\n";
    test_print(v, 2, 4, 3);
    
    // update every value in the first columns of both planes
    v[std::gslice(0, {2, 4}, {4 * 3, 3})] = 1; // two level one strides of 12 elements
                                               // then four level two strides of 3 elements
    
    // subtract the third column from the second column in the 1st plane
    v[std::gslice(1, {1, 4}, {4 * 3, 3})] -= v[std::gslice(2, {1, 4}, {4 * 3, 3})];
    
    std::cout << "\n" "After column operations:\n";
    test_print(v, 2, 4, 3);
}

Вывод:

Initial 2x4x3 array:
111 112 113   211 212 213
121 122 123   221 222 223
131 132 133   231 232 233
141 142 143   241 242 243

After column operations:
1 -1 113   1 212 213
1 -1 123   1 222 223
1 -1 133   1 232 233
1 -1 143   1 242 243

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применён к	Опубликованное поведение	Правильное поведение
LWG 543	C++98	было неясно, можно ли использовать обобщённый срез, созданный конструктором по умолчанию	его можно использовать (как пустое подмножество)

См. также

operator[]	получает/задаёт элемент valarray, срез или маску (открытая функция-член)
slice	срез valarray в стиле BLAS: начальный индекс, длина, шаг (класс)
gslice_array	прокси для подмножества valarray после применения gslice (шаблон класса)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/numeric/valarray/gslice