Javatpoint Logo
Javatpoint Logo

cshift() function for valarray in C++

The Standard Template Library (STL) in C++ has the cshift() function, which is utilized with std::valarray. Depending on the supplied shift count, this function moves the elements in a valarray in a circular manner, either to the left or the right. Elements that are moved out from one end are brought back to the other end because the shift is circular.

Comprehending the C++ cshift() function with std::Valarray:-

The Standard Template Library (STL) in C++ includes std::valarray, which is an array-like container meant for numerical computations. It offers easy syntax, efficiency optimizations for numerical processing, and high-level abstractions for mathematical operations on arrays of numbers.

Characteristics of std::valarray:-

It has several characteristics of Std::valarray in C++. Some main characteristics of Std::valarray in C++ are as follows:

1. Array-style Behaviour:

  • Std::valarray stores elements in a single, continuous block of memory and operates similarly to an array. It supports standard array operations like indexing and iteration and offers random access to entries.

2. Numerical Operations:

  • This class provides a large range of built-in mathematical functions and overload operators to conduct element-wise arithmetic operations like addition, subtraction, multiplication, division, etc.
  • The purpose of these operations is to process arrays of numeric values in an efficient manner.

3. Efficient Expression Evaluation:

  • The evaluation of mathematical expressions is optimized via std::valarray.
  • In certain situations, it can enhance efficiency by delaying processing until it's absolutely essential, rather than computing intermediate results for every action manually.

4. Support for Parallel Processing:

  • A lot of compilers and libraries use parallelization techniques to speed up calculations utilizing std::valarray.
  • Concurrent operations on valarray elements can make use of multi-core systems for improved performance.

What is cshift() function?

The cshift() function is used to execute circular shifts inside a valarray, which is a component of the std::valarray module of the C++ Standard Library. It offers an easy technique to move elements in a valarray in a circular pattern to the left or right.

Up to the provided shift count, the function shifts elements starting at the end of the valarray to the left. The beginning of the array is where elements that are moved out from the end are placed.


It has the following syntax:

count: An integer that indicates how many places need to be moved. Elements are shifted to the left by a positive value and to the right by a negative value.


Left Shift (Positive Count):

  • The designated count causes elements to be pushed to the left.
  • In a circular motion, elements that are moved out from the beginning of the valarray are moved to the end.

Right Shift (Negative Count):

  • The supplied count's absolute value is used to shift elements to the right.
  • Moving out from the end of the valarray, elements are moved in a circular motion back to the beginning.


Let us take a program to illustrate the usage of cshift() function in C++:


cshift() function for valarray in C++


The code illustrates how to do circular shifts of elements within an array-like structure by using the cshift() method with std::valarray. The following stages will illustrate the rationale of the code:

1. Initialization:

  • Make a values valarray with the integers {1, 2, 3, 4, 5} in it.

2. Present Original Valarray:

  • Before doing any shifting operations, print the values in the values array.

3. Left Shift by Number of Positives:

  • Use the cshift() function to shift left by a positive count (in this case, two positions).
  • After that, two positions are added to the elements' left. Circular shifts in elements from the beginning are brought back to the end.

4. Show Valarray Following a Left Shift:

  • After the left shift operation, print the values in the values array.

5. Right Shift by Negative Count:

  • Use the cshift() function to shift right by a negative count (in this case, 1 position).
  • A single place is added to the elements' right. In a circular motion, elements that are moved out from the end are returned to the beginning.

6. Show Valarray After a Right Shift:

  • After the right shift, print the contents of the values valarray.

The main objective of the code is to illustrate how the cshift() method in the std::valarray exhibits circular shifting behavior. It illustrates how elements in the array-like structure can be cycle-shifted to the left and right, with each shift operation displaying the contents of the resulting valarray.


In conclusion, C++'s std::valarray provides an expressive and effective interface that makes numerical operations involving data arrays simpler. It is an invaluable tool for scientific computing, data manipulation, and other situations requiring numerical processing because of its optimized design and support for mathematical operations.

Youtube For Videos Join Our Youtube Channel: Join Now


Help Others, Please Share

facebook twitter pinterest

Learn Latest Tutorials


Trending Technologies

B.Tech / MCA