26 Numerics library [numerics]

26.7 Numeric arrays [numarray]

26.7.2 Class template valarray [template.valarray]

26.7.2.2 valarray constructors [valarray.cons]

valarray();

1

Effects: Constructs an object of class valarray<T>278 which has zero length.279

explicit valarray(size_t);

2

The array created by this constructor has a length equal to the value of the argument. The elements of the array are value-initialized ([dcl.init]).

valarray(const T&, size_t);

3

The array created by this constructor has a length equal to the second argument. The elements of the array are initialized with the value of the first argument.

valarray(const T*, size_t);

4

The array created by this constructor has a length equal to the second argument n. The values of the elements of the array are initialized with the first n values pointed to by the first argument.280 If the value of the second argument is greater than the number of values pointed to by the first argument, the behavior is undefined.

valarray(const valarray&);

5

The array created by this constructor has the same length as the argument array. The elements are initialized with the values of the corresponding elements of the argument array.281

valarray(valarray&& v) noexcept;

6

The array created by this constructor has the same length as the argument array. The elements are initialized with the values of the corresponding elements of the argument array.

7

Complexity: Constant.

valarray(initializer_list<T> il);

8

Effects: Same as valarray(il.begin(), il.size()).

valarray(const slice_array<T>&); valarray(const gslice_array<T>&); valarray(const mask_array<T>&); valarray(const indirect_array<T>&);

9

These conversion constructors convert one of the four reference templates to a valarray.

~valarray();

10

The destructor is applied to every element of *this; an implementation may return all allocated memory.

278)

For convenience, such objects are referred to as “arrays” throughout the remainder of [numarray].

279)

This default constructor is essential, since arrays of valarray may be useful. After initialization, the length of an empty array can be increased with the resize member function.

280)

This constructor is the preferred method for converting a C array to a valarray object.

281)

This copy constructor creates a distinct array rather than an alias. Implementations in which arrays share storage are permitted, but they shall implement a copy-on-reference mechanism to ensure that arrays are conceptually distinct.