Computes natural logarithm of vector elements.
Syntax
FORTRAN:
call vsln( n, a, y )
call vmsln( n, a, y, mode )
call vdln( n, a, y )
call vmdln( n, a, y, mode )
call vcln( n, a, y )
call vmcln( n, a, y, mode )
call vzln( n, a, y )
call vmzln( n, a, y, mode )
C:
vsLn( n, a, y );
vmsLn( n, a, y, mode );
vdLn( n, a, y );
vmdLn( n, a, y, mode );
vcLn( n, a, y );
vmcLn( n, a, y, mode );
vzLn( n, a, y );
vmzLn( n, a, y, mode );
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 vsln, vmsln DOUBLE PRECISION for vdln, vmdln COMPLEX for vcln, vmcln DOUBLE COMPLEX for vzln, vmzln Fortran 90: REAL, INTENT(IN) for vsln, vmsln DOUBLE PRECISION, INTENT(IN) for vdln, vmdln COMPLEX, INTENT(IN) for vcln, vmcln DOUBLE COMPLEX, INTENT(IN) for vzln, vmzln C: const float* for vsLn, vmsLn const double* for vdLn, vmdLn const MKL_Complex8* for vcLn, vmcLn const MKL_Complex16* for vzLn, vmzLn |
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. |
Output Parameters
Name |
Type |
Description |
|---|---|---|
y |
FORTRAN 77: REAL for vsln, vmsln DOUBLE PRECISION for vdln, vmdln COMPLEX for vcln, vmcln DOUBLE COMPLEX for vzln, vmzln Fortran 90: REAL, INTENT(OUT) for vsln, vmsln DOUBLE PRECISION, INTENT(OUT) for vdln, vmdln COMPLEX, INTENT(OUT) for vcln, vmcln DOUBLE COMPLEX, INTENT(OUT) for vzln, vmzln C: float* for vsLn, vmsLn double* for vdLn, vmdLn MKL_Complex8* for vcLn, vmcLn MKL_Complex16* for vzLn, vmzLn |
FORTRAN: Array that specifies the output vector y. C: Pointer to an array that contains the output vector y. |
Description
The v?Ln function computes natural logarithm of vector elements.
| Argument | Result | VML Error Status | Exception |
|---|---|---|---|
| +1 | +0 | ||
| X < +0 | QNAN | VML_STATUS_ERRDOM | INVALID |
| +0 | -∞ | VML_STATUS_SING | ZERODIVIDE |
| -0 | -∞ | VML_STATUS_SING | ZERODIVIDE |
| -∞ | QNAN | VML_STATUS_ERRDOM | INVALID |
| +∞ | +∞ | ||
| QNAN | QNAN | ||
| SNAN | QNAN | INVALID |
See Special Value Notations for the conventions used in the table below.
RE(z) i·IM(z) |
-∞
|
-X
|
-0
|
+0
|
+X
|
+∞
|
NAN
|
|---|---|---|---|---|---|---|---|
| +i·∞ |  |
+∞+i·π/2 | +∞+i·π/2 | +∞+i·π/2 | +∞+i·π/2 | +∞+i·π/4 | +∞+i·QNAN |
| +i·Y | +∞+i·π | +∞+i·0 | QNAN+i·QNAN INVALID |
||||
| +i·0 | +∞+i·π | -∞+i·π ZERODIVIDE | -∞+i·0 ZERODIVIDE | +∞+i·0 | QNAN+i·QNAN INVALID |
||
| -i·0 | +∞-i·π | -∞-i·π ZERODIVIDE | -∞-i·0 ZERODIVIDE | +∞-i·0 | QNAN+i·QNAN INVALID |
||
| -i·Y | +∞-i·π | +∞-i·0 | QNAN+i·QNAN INVALID |
||||
| -i·∞ |  |
+∞-i·π/2 | +∞-i·π/2 | +∞-i·π/2 | +∞-i·π/2 | +∞-i·π/4 | +∞+i·QNAN |
| +i·NAN | +∞+i·QNAN |
QNAN+i·QNAN INVALID |
QNAN+i·QNAN INVALID |
QNAN+i·QNAN INVALID |
QNAN+i·QNAN INVALID |
+∞+i·QNAN |
QNAN+i·QNAN INVALID |
Notes:
raises INVALID exception when real or imaginary part of the argument is SNAN