std::gslice

class gslice;

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

Члены-функции

gslice()

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

gslice( const gslice& other );

std::size_t start() const;

std::valarray<std::size_t> size() const;

std::valarray<std::size_t> stride() const;

Пример

#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++.

См. также