v?CIS

Computes complex exponent of real vector elements (cosine and sine of real vector elements combined to complex value).

Syntax

Fortran:

call vccis( n, a, y )

call vmccis( n, a, y, mode )

call vzcis( n, a, y )

call vmzcis( n, a, y, mode )

vcCIS( n, a, y );

vmcCIS( n, a, y, mode );

vzCIS( n, a, y );

vmzCIS( n, a, y, mode );

Include Files

The FORTRAN 77 interfaces are specified in the mkl_vml.f77 include file, the Fortran 90 interfaces are specified in the mkl_vml.f90 include file, and the C interfaces are specified in the mkl_vml_functions.h include file.

Input Parameters

Name	Type	Description
n	FORTRAN 77: INTEGER Fortran 90: INTEGER, INTENT(IN) C: const int	Specifies the number of elements to be calculated.
a	FORTRAN 77: REAL for vccis, vmccis DOUBLE PRECISION for vzcis, vmzcis Fortran 90: REAL, INTENT(IN) for vccis, vmccis DOUBLE PRECISION, INTENT(IN) for vzcis, vmzcis C: const float* for vcCIS, vmcCIS const double* for vzCIS, vmzCIS	FORTRAN: Array that specifies the input vector a. C: Pointer to an array that contains the input vector a.
mode	FORTRAN 77: INTEGER8 Fortran 90:* INTEGER(KIND=8), INTENT(IN) C: const MKL_INT64	Overrides global VML mode setting for this function call. See SetMode for possible values and their description.

Name

Type

Description

FORTRAN 77: INTEGER

Fortran 90: INTEGER, INTENT(IN)

C: const int

Specifies the number of elements to be calculated.

FORTRAN 77: REAL for vccis, vmccis

DOUBLE PRECISION for vzcis, vmzcis

Fortran 90: REAL, INTENT(IN) for vccis, vmccis

DOUBLE PRECISION, INTENT(IN) for vzcis, vmzcis

C: const float* for vcCIS, vmcCIS

const double* for vzCIS, vmzCIS

FORTRAN: Array that specifies the input vector a.

C: Pointer to an array that contains the input vector a.

mode

FORTRAN 77: INTEGER*8

Fortran 90: INTEGER(KIND=8), INTENT(IN)

C: const MKL_INT64

Overrides global VML mode setting for this function call. See SetMode for possible values and their description.

Output Parameters

Name	Type	Description
y	FORTRAN 77: COMPLEX for vccis, vmccis DOUBLE COMPLEX for vzcis, vmzcis Fortran 90: COMPLEX, INTENT(OUT) for vccis, vmccis DOUBLE COMPLEX, INTENT(OUT) for vzcis, vmzcis C: MKL_Complex8* for vcCIS, vmcCIS MKL_Complex16* for vzCIS, vmzCIS	FORTRAN: Array that specifies the output vector y. C: Pointer to an array that contains the output vector y.

Name

Type

Description

FORTRAN 77: COMPLEX for vccis, vmccis

DOUBLE COMPLEX for vzcis, vmzcis

Fortran 90: COMPLEX, INTENT(OUT) for vccis, vmccis

DOUBLE COMPLEX, INTENT(OUT) for vzcis, vmzcis

C: MKL_Complex8* for vcCIS, vmcCIS

MKL_Complex16* for vzCIS, vmzCIS

FORTRAN: Array that specifies the output vector y.

C: Pointer to an array that contains the output vector y.

Description

The v?CIS function computes complex exponent of real vector elements (cosine and sine of real vector elements combined to complex value).

See Special Value Notations for the conventions used in the table below.

Special Values for Complex Function v?CIS(x)
x	CIS(x)
+ ∞	QNAN+i·QNAN INVALID
+ 0	+1+i·0
- 0	+1-i·0
- ∞	QNAN+i·QNAN INVALID
NAN	QNAN+i·QNAN

Notes:

raises INVALID exception when the argument is SNAN
raises INVALID exception and sets the VML Error Status to VML_STATUS_ERRDOM for x=+∞, x=-∞