From cppreference.com
template<classT>classvalarray;std::valarray is the class for representing and manipulating arrays of values. It supports element-wise mathematical operations and various forms of generalized subscript operators, slicing and indirect access.
Template parameters
T - the type of the elements. The type must meet the
requirements Member types
Member functions
constructs new numeric array
(public member function)
destructs the numeric array
(public member function)
assigns the contents
(public member function)
get/set valarray element, slice, or mask
(public member function)
operator+operator-operator~operator!
applies a unary arithmetic operator to each element of the valarray
(public member function)
applies compound assignment operator to each element of the valarray
(public member function)
swaps with another valarray
(public member function)
returns the size of valarray
(public member function)
changes the size of valarray
(public member function)
calculates the sum of all elements
(public member function)
returns the smallest element
(public member function)
returns the largest element
(public member function)
zero-filling shift the elements of the valarray
(public member function)
circular shift of the elements of the valarray
(public member function)
applies a function to every element of a valarray
(public member function)
(C++11)
obtains the beginning iterator of valarray
(public member function)
(C++11)
obtains the past-the-end iterator of valarray
(public member function)
Non-member functions
(C++11)
specializes the
algorithm
(function template)
applies binary operators to each element of two valarrays, or a valarray and a value
(function template)
operator==operator!=operator<operator<=operator>operator>=
compares two valarrays or a valarray with a value
(function template)
applies the function abs to each element of valarray
(function template)
Exponential functions
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
Power functions
applies the function
to two valarrays or a valarray and a value
(function template)
applies the function
to each element of valarray
(function template)
Trigonometric functions
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
applies the function
to a valarray and a value
(function template)
Hyperbolic functions
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
applies the function
to each element of valarray
(function template)
Helper classes
BLAS-like slice of a valarray: starting index, length, stride
(class)
proxy to a subset of a valarray after applying a slice
(class template)
generalized slice of a valarray: starting index, set of lengths, set of strides
(class)
proxy to a subset of a valarray after applying a gslice
(class template)
proxy to a subset of a valarray after applying a boolean mask operator[]
(class template)
proxy to a subset of a valarray after applying indirect operator[]
(class template)
(since C++17)
Notes
std::valarray and helper classes are defined to be free of certain forms of aliasing, thus allowing operations on these classes to be optimized similar to the effect of the keyword
in the C programming language. In addition, functions and operators that take valarray arguments are allowed to return proxy objects to make it possible for the compiler to optimize an expression such as v1=a*v2+v3; as a single loop that executes v1[i]=a*v2[i]+v3[i]; avoiding any temporaries or multiple passes. However,
make the same optimization technique available for any C++ container, and the majority of numeric libraries prefer expression templates to valarrays for flexibility. Some C++ standard library implementations use expression templates to implement efficient operations on std::valarray (e.g. GNU libstdc++ and LLVM libc++). Only rarely are valarrays optimized any further, as in e.g.
Intel Integrated Performance Primitives
.
macro ValueStdFeature
(C++26)
(DR11)begin and end member functions, and iterator and const_iterator member types of std::valarray
As of 2026-05-27, libstdc++ has not treated the modifications of begin and end functions from
as a defect report against C++11, and only applies the changes since C++26.
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR Applied to Behavior as published Correct behavior
C++11 1) valarray lacked member types iterator and const_iterator
2) valarray had inconsistent non-member begin() and end() functions 1) member types added
2) changed to member functions See also
(C++26)
data-parallel vector type
(class template)
(C++26)
convenience alias template for basic_vec that can specify its width
(alias template)
(C++26)
data-parallel type with the element type bool
(class template)
(C++26)
convenience alias template for basic_mask that can specify its width
(alias template)