Computes the gamma function of vector elements.
FORTRAN:
call vstgamma( n, a, y )
call vmstgamma( n, a, y, mode )
call vdtgamma( n, a, y )
call vmdtgamma( n, a, y, mode )
C:
vsTGamma( n, a, y );
vmsTGamma( n, a, y, mode );
vdTGamma( n, a, y );
vmdTGamma( n, a, y, mode );
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 vmlSetMode for possible values and their description. |
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. |
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.
| 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 |