Complex.Asin(Complex) Method

Reference

Definition

Namespace:: System.Numerics

Assemblies:: System.Numerics.dll, System.Runtime.Numerics.dll

Assemblies:: netstandard.dll, System.Runtime.Numerics.dll

Assembly:: System.Runtime.Numerics.dll

Assembly:: System.Numerics.dll

Assembly:: netstandard.dll

Source:: Complex.cs

Source:: Complex.cs

Source:: Complex.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns the angle that is the arc sine of the specified complex number.

public:
 static System::Numerics::Complex Asin(System::Numerics::Complex value);

public static System.Numerics.Complex Asin(System.Numerics.Complex value);

static member Asin : System.Numerics.Complex -> System.Numerics.Complex

Public Shared Function Asin (value As Complex) As Complex

Parameters

value: Complex

A complex number.

Returns

Complex

The angle which is the arc sine of value.

Examples

The following example illustrates the Asin method. It shows that passing the value returned by the Asin method to the Sin method returns the original Complex value.

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] values = { new Complex(2.3, 1.4),
                           new Complex(-2.3, 1.4),
                           new Complex(-2.3, -1.4),
                           new Complex(2.3, -1.4) };
      foreach (Complex value in values)
         Console.WriteLine("Sin(Asin({0})) = {1}",
                            value, Complex.Sin(Complex.Asin(value)));
   }
}
// The example displays the following output:
//       Sin(Asin((2.3, 1.4))) = (2.3, 1.4)
//       Sin(Asin((-2.3, 1.4))) = (-2.3, 1.4)
//       Sin(Asin((-2.3, -1.4))) = (-2.3, -1.4)
//       Sin(Asin((2.3, -1.4))) = (2.3, -1.4)

open System.Numerics

let values =
    [ Complex(2.3, 1.4)
      Complex(-2.3, 1.4)
      Complex(-2.3, -1.4)
      Complex(2.3, -1.4) ]

for value in values do
    printfn $"Sin(Asin({value})) = {Complex.Asin value |> Complex.Sin}"
// The example displays the following output:
//       Sin(Asin((2.3, 1.4))) = (2.3, 1.4)
//       Sin(Asin((-2.3, 1.4))) = (-2.3, 1.4)
//       Sin(Asin((-2.3, -1.4))) = (-2.3, -1.4)
//       Sin(Asin((2.3, -1.4))) = (2.3, -1.4)

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim values() As Complex = { New Complex(2.3, 1.4),
                                  New Complex(-2.3, 1.4), 
                                  New Complex(-2.3, -1.4),
                                  New Complex(2.3, -1.4) }
      For Each value As Complex In values
         Console.WriteLine("Sin(Asin({0})) = {1}", 
                            value, Complex.Sin(Complex.Asin(value)))
      Next                      
   End Sub
End Module
' The example displays the following output:
'       Sin(Asin((2.3, 1.4))) = (2.3, 1.4)
'       Sin(Asin((-2.3, 1.4))) = (-2.3, 1.4)
'       Sin(Asin((-2.3, -1.4))) = (-2.3, -1.4)
'       Sin(Asin((2.3, -1.4))) = (2.3, -1.4)

Remarks

The Asin method for complex numbers corresponds to the Math.Asin method for real numbers.

The Asin method uses the following formula:

-ImaginaryOne * Log(ImaginaryOne * value + Sqrt(One - value * value))

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Share via