Namespaces
Variants

std:: gslice

From cppreference.net
Определено в заголовочном файле <valarray>
class gslice ;

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

При заданном начальном значении s , списке шагов i j и списке размеров d j , объект std::gslice , созданный из этих значений, выбирает набор индексов k j =s+Σ j (i j d 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

**Примечание:** Весь представленный текст является математическими выражениями и числовыми значениями, которые не требуют перевода согласно вашим инструкциям. HTML-разметка и содержимое внутри тегов ` ` с классами C++ сохранены без изменений.

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

Содержание

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

(constructor)
создает общий срез
(public member function)
start size stride
возвращает параметры среза
(public member function)

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 Applied to Behavior as published Correct behavior
LWG 543 C++98 было неясно, можно ли использовать сконструированный по умолчанию обобщенный срез он является используемым (как пустое подмножество)

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

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