atan2 (<valarray>)

Artigo
02/24/2013

Retorna um valarray cujos elementos sejam iguais ao arctangent de componentes cartesianos especificados por uma combinação de constantes e elementos de valarrays.

template<class Type>
   valarray<Type> atan2(
      const valarray<Type>& _Left,
      const valarray<Type>& _Right
   );
template<class Type>
   valarray<Type> atan2(
      const valarray<Type> _Left, 
      const Type& _Right
   );
template<class Type>
   valarray<Type> atan2(
      const Type& _Left, 
      const valarray<Type>& _Right
   );

Parâmetros

_Left
O tipo de dados ou entrada numérica constante valarray cujos elementos fornecem os valores para a coordenada y do argumento de arctangent.
_Right
O tipo de dados ou entrada numérica constante valarray cujos elementos fornecem os valores para a coordenada x do argumento de arctangent.

Valor de retorno

Um valarray de cujos elementos I é igual ao arctangent:

_Left de I /[] [] _Right I para a primeira função do modelo.
[]_Left de I / _Right para a segunda função do modelo.
_Left /[] _Right I para a terceira função do modelo.

Comentários

As unidades de elementos são retornados em radianos.

Essa função preserva informações sobre os sinais de componentes no argumento que é perdido pela função padrão da tangente, e esse conhecimento do quadrante permite que o valor de retorno para ser atribuído um ângulo exclusivo entre +pi e – pi.

Se _Left e _Right têm um número diferente de elementos, o resultado é indefinido.

Exemplo

// valarray_atan2.cpp
// compile with: /EHsc
#include <valarray>
#include <iostream>
#include <iomanip>

int main( )
{
   using namespace std;
   double pi = 3.14159265359;
   int i;

   valarray<double> va1y ( 1 , 4 ), va1x ( 1 , 4 );
   va1x [ 1 ] = -1;
   va1x [ 2 ] = -1;
   va1y [ 2 ] = -1;
   va1y [ 3 ] = -1;
   valarray<double> va2 ( 4 );

   cout << "The initial valarray for the x coordinate is: ( ";
   for ( i = 0 ; i < 4 ; i++ )
      cout << va1x [ i ] << " ";
   cout << ")." << endl;

   cout << "The initial valarray for the y coordinate is: ( ";
   for ( i = 0 ; i < 4 ; i++ )
      cout << va1y [ i ] << " ";
   cout << ")." << endl;

   va2 = atan2 ( va1y , va1x );
   cout << "The atan2 ( y / x ) of the initial valarrays is:\n";
   for ( i = 0 ; i < 4 ; i++ )
      cout << setw( 10 ) << va2 [ i ]
           << "  radians, which is  "
           << setw( 11 ) << ( 180/pi ) * va2 [ i ]
           << "degrees" << endl;
   cout << endl;
}

Requisitos

Cabeçalho: <valarray>

namespace: STD

Partilhar via