std::valarray<T>:: cshift
|
valarray
<
T
>
cshift
(
int
décalage
)
const
;
|
||
Retourne un nouveau valarray de même taille avec des éléments dont les positions sont décalées circulairement de count éléments.
Une valeur non négative de count décale les éléments circulairement vers la gauche de count positions et une valeur négative de count décale les éléments circulairement vers la droite de - count positions.
Table des matières |
Paramètres
| count | - | nombre de positions pour décaler les éléments |
Valeur de retour
Le valarray résultant avec les éléments décalés circulairement.
Notes
La fonction peut être implémentée avec un type de retour différent de std::valarray . Dans ce cas, le type de remplacement possède les propriétés suivantes :
-
- Toutes const les fonctions membres de std::valarray sont fournies.
- std::valarray , std::slice_array , std::gslice_array , std::mask_array et std::indirect_array peuvent être construits à partir du type de remplacement.
- Pour chaque fonction prenant un const std:: valarray < T > & sauf begin() et end() (depuis C++11) , des fonctions identiques prenant les types de remplacement doivent être ajoutées ;
- Pour chaque fonction prenant deux const std:: valarray < T > & arguments, des fonctions identiques prenant chaque combinaison de const std:: valarray < T > & et types de remplacement doivent être ajoutées.
- Le type de retour n'ajoute pas plus de deux niveaux d'imbrication de templates par rapport au type d'argument le plus profondément imbriqué.
Exemple
#include <iostream> #include <valarray> int main() { std::valarray<int> v{1, 2, 3, 4, 5, 6, 7, 8}; for (auto const& val : v) std::cout << val << ' '; std::cout << '\n'; std::valarray<int> v2 = v.cshift(2); for (auto const& val : v2) std::cout << val << ' '; std::cout << '\n'; }
Sortie :
1 2 3 4 5 6 7 8 3 4 5 6 7 8 1 2
Rapports de défauts
Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.
| DR | Appliqué à | Comportement tel que publié | Comportement correct |
|---|---|---|---|
| LWG 618 | C++98 |
l'expression des éléments décalés
contient une division par zéro si
size()
est
0
|
décrit les nouvelles positions
sans utiliser d'expressions |
Voir aussi
|
décalage avec remplissage par des zéros des éléments du valarray
(fonction membre publique) |