std::gslice(3)

💖 std::gslice 💖

okay bestie, welcome to the Library Functions Manual entry for std::gslice — she's a whole vibe and she's about to teach you how to carve a multi-dimensional subset out of an array. no cap. 🦋

---

✨ NAME ✨

std::gslice — Class defining multi-dimensional subset of an array.

like, imagine a regular slice but make it dimensional. she's giving main character energy fr fr. 👑

---

✨ SYNOPSIS ✨

#include <valarray>

🌸 Public Member Functions 🌸

• gslice () — Construct an empty slice. (yes, an empty one. she exists but she's got nothing going on. still iconic tho 💅)
• gslice (const gslice &) — Copy constructor. clone her, she doesn't mind 🫶
• gslice (size_t __o, const valarray< size_t > &__l, const valarray< size_t > &__s) — Construct a slice. this is the one, this is the moment ✨
• ~gslice () — Destructor. she's done, she's leaving, no drama 💀
• gslice & operator= (const gslice &) — Assignment operator. you become her, she becomes you, it's a whole thing 🌈
• valarray< size_t > size () const — Return array of sizes of slice dimensions.
• size_t start () const — Return array offset of first slice element.
• valarray< size_t > stride () const — Return array of array strides for each dimension.

🧚 Friends 🧚

• template<typename _Tp> class valarray

aww look at them, they're friends 🥹 the valarray class gets to hang out in here.

---

✨ Detailed Description ✨

Class defining multi-dimensional subset of an array.

so here's the tea ☕ the slice class represents a multi-dimensional subset of an array, and it's specified by three parameter sets, bestie:

1. start offset
2. size array
3. stride array

the start offset is the index of the first element of the array that is part of the subset. periodt. 💅

the size and stride array describe each dimension of the slice:

• Size is the number of elements in that dimension.
• stride is the distance in the array between successive elements in that dimension.

each dimension's size and stride is taken to begin at an array element described by the previous dimension. 🔥 and — super important, don't skip this — the size array and stride array must be the same size. they're a matched set, they're soulmates, don't split them up 😭

---

okay so for example, if you have:

offset==3, stride[0]==11, size[1]==3, stride[1]==3

then:

slice[0,0]==array[3], slice[0,1]==array[6], slice[0,2]==array[9],
slice[1,0]==array[14], slice[1,1]==array[17], slice[1,2]==array[20]

the way those indices just land perfectly?? ate. no crumbs. 🍓✨

---

✨ Author ✨

Generated automatically by Doxygen for libstdc++ from the source code.

(not me being jealous of an auto-generated author credit 💀)

---

and that's the whole page bestie!! 🎀 she's part of libstdc++, she's a Library Functions Manual girlie, and yes — std::gslice(3) is literally the name at the top and the bottom because that's just how manpages do. obsessed with the symmetry ngl. 🌸🦋💜