The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

# operator- (<valarray>)

Obtains the element-wise difference between corresponding elements of two equally sized valarrays or of between a valarray a specified value.

## Syntax

```template<class Type>
valarray<Type> operator-(
const valarray<Type>& _Left,
const valarray<Type>& _Right
);
template<class Type>
valarray<Type> operator-(
const valarray<Type>& _Left,
const Type& _Right
);
template<class Type>
valarray<Type> operator-(
const Type& _Left,
const valarray<Type>& _Right
);
```

## Parameters

_Left

A value or valarray that serves as the minuend from which other values or valarrays are to be subtracted in forming the difference.

_Right

A value or valarray that serves as the subtrahend that is to be subtracted from other values or valarrays in forming the difference.

## Return Value

A valarray whose elements are the element-wise difference of _Left and _Right.

## Remarks

The arithmetic terminology used in describing a subtraction:

difference = minuend - subtrahend

## Example

```// valarray_op_ediff.cpp
// compile with: /EHsc
#include <valarray>
#include <iostream>

int main( )
{
using namespace std;
int i;

valarray<int> vaL ( 8 ), vaR ( 8 );
valarray<int> vaNE ( 8 );
for ( i = 0 ; i < 8 ; i += 2 )
vaL [ i ] =  10;
for ( i = 1 ; i < 8 ; i += 2 )
vaL [ i ] =  0;
for ( i = 0 ; i < 8 ; i++ )
vaR [ i ] =  i;

cout << "The initial Left valarray is: ( ";
for ( i = 0 ; i < 8 ; i++ )
cout << vaL [ i ] << " ";
cout << ")." << endl;

cout << "The initial Right valarray is: ( ";
for ( i = 0 ; i < 8 ; i++ )
cout << vaR [ i ] << " ";
cout << ")." << endl;

vaNE = ( vaL - vaR );
cout << "The element-by-element result of "
<< "the difference is the\n valarray: ( ";
for (i = 0 ; i < 8 ; i++ )
cout << vaNE [ i ] << " ";
cout << ")." << endl;
}
```
```The initial Left valarray is: ( 10 0 10 0 10 0 10 0 ).
The initial Right valarray is: ( 0 1 2 3 4 5 6 7 ).
The element-by-element result of the difference is the
valarray: ( 10 -1 8 -3 6 -5 4 -7 ).```