C++ Valarray Library - asin Function

---

---

Description

It returns a valarray object containing the principal values of the arc sine of all the elements of x, expressed in radians, in the same order.

Declaration

Following is the declaration for std::asin function.

template<class T> valarray<T> asin (const valarray<T>& x);

C++11

template<class T> valarray<T> asin (const valarray<T>& x);

Parameters

x − It is containing elements of a type for which the unary function abs is defined.

Return Value

It returns a valarray object containing the principal values of the arc sine of all the elements of x, expressed in radians, in the same order.

Exceptions

Basic guarantee − if any operation performed on the elements throws an exception.

Data races

All elements effectively copied are accessed.

Example

In below example explains about std::asin function.

#include <iostream>    
#include <cstddef>     
#include <cmath>       
#include <valarray>    

int main () {
   double val[] = {0.0, 0.2, 0.5, 0.7, 1.0};
   std::valarray<double> foo (val,5);

   std::valarray<double> bar = asin (foo);

   std::cout << "foo:";
   for (std::size_t i=0; i<foo.size(); ++i)
      std::cout << ' ' << foo[i];
   std::cout << '\n';

   std::cout << "bar:";
   for (std::size_t i=0; i<bar.size(); ++i)
      std::cout << ' ' << bar[i];
   std::cout << '\n';

   return 0;
}

Let us compile and run the above program, this will produce the following result −

foo: 0 0.2 0.5 0.7 1
bar: 0 0.201358 0.523599 0.775397 1.5708