v?TGamma

Computes the gamma function of vector elements.

Syntax

Fortran:

call vstgamma( n, a, y )

call vmstgamma( n, a, y, mode )

call vdtgamma( n, a, y )

call vmdtgamma( n, a, y, mode )

vsTGamma( n, a, y );

vmsTGamma( n, a, y, mode );

vdTGamma( n, a, y );

vmdTGamma( 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 vstgamma, vmstgamma DOUBLE PRECISION for vdtgamma, vmdtgamma Fortran 90: REAL, INTENT(IN) for vstgamma, vmstgamma DOUBLE PRECISION, INTENT(IN) for vdtgamma, vmdtgamma C: const float* for vsTGamma, vmsTGamma const double* for vdTGamma, vmdTGamma	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

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 vstgamma, vmstgamma

DOUBLE PRECISION for vdtgamma, vmdtgamma

Fortran 90: REAL, INTENT(IN) for vstgamma, vmstgamma

DOUBLE PRECISION, INTENT(IN) for vdtgamma, vmdtgamma

C: const float* for vsTGamma, vmsTGamma

const double* for vdTGamma, vmdTGamma

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: REAL for vstgamma, vmstgamma DOUBLE PRECISION for vdtgamma, vmdtgamma Fortran 90: REAL, INTENT(OUT) for vstgamma, vmstgamma DOUBLE PRECISION, INTENT(OUT) for vdtgamma, vmdtgamma C: float* for vsTGamma, vmsTGamma double* for vdTGamma, vmdTGamma	FORTRAN: Array that specifies the output vector y. C: Pointer to an array that contains the output vector y.

Name

Type

Description

y

FORTRAN 77: REAL for vstgamma, vmstgamma

DOUBLE PRECISION for vdtgamma, vmdtgamma

Fortran 90: REAL, INTENT(OUT) for vstgamma, vmstgamma

DOUBLE PRECISION, INTENT(OUT) for vdtgamma, vmdtgamma

C: float* for vsTGamma, vmsTGamma

double* for vdTGamma, vmdTGamma

FORTRAN: Array that specifies the output vector y.

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

Description

The v?TGamma function computes the gamma function for elements of the input vector a and writes them to the output vector y. Precision overflow thresholds for the v?TGamma function are beyond the scope of this document. If the result does not meet the target precision, the function raises the OVERFLOW exception and sets the VML Error Status to VML_STATUS_OVERFLOW.

Special Values for Real Function v?TGamma(x)
Argument	Result	VML Error Status	Exception
+0	+∞	VML_STATUS_SING	ZERODIVIDE
-0	-∞	VML_STATUS_SING	ZERODIVIDE
negative integer	QNAN	VML_STATUS_ERRDOM	INVALID
-∞	QNAN	VML_STATUS_ERRDOM	INVALID
+∞	+∞
X > overflow	+∞	VML_STATUS_OVERFLOW	OVERFLOW
QNAN	QNAN
SNAN	QNAN		INVALID

v?TGamma

Syntax

Include Files

Input Parameters

Output Parameters

Description

See Also