v?NextAfter
v?NextAfter
Returns vector of elements containing the next representable floating-point values following the values from the elements of one vector in the direction of the corresponding elements of another vector.
Syntax
vsNextAfter
(
n
,
a
,
b
,
y
);
vsNextAfterI(n, a, inca, b, incb, y, incy);
vmsNextAfter
(
n
,
a
,
b
,
y
,
mode
);
vmsNextAfterI(n, a, inca, b, incb, y, incy, mode);
vdNextAfter
(
n
,
a
,
b
,
y
);
vdNextAfterI(n, a, inca, b, incb, y, incy);
vmdNextAfter
(
n
,
a
,
b
,
y
,
mode
);
vmdNextAfterI(n, a, inca, b, incb, y, incy, mode);
Include Files
- mkl.h
Input Parameters
Name | Type | Description |
---|---|---|
n | const MKL_INT | Specifies the number of elements to be calculated. |
a , b | const float* for vsNextAfter const float* for vmsNextAfter const double* for vdNextAfter const double* for vmdNextAfter | Pointers to the arrays containing the input vectors a and b . |
inca , incb , incy | const MKL_INT | Specifies increments for the elements of a , b , and y . |
mode | const MKL_INT64 | Overrides the global VM mode setting for this
function call. See
vmlSetMode
for possible values and their
description. |
Output Parameters
Name | Type | Description |
---|---|---|
y | float* for vsNextAfter float* for vmsNextAfter double* for vdNextAfter double* for vmdNextAfter | Pointer to an array containing the output vector y . |
Description
The
v?NextAfter
function returns a vector containing the next representable floating-point values following the first vector argument elements in the direction of the second vector argument's corresponding elements.Special cases:
- Overflow
- The function raises overflow and inexact floating-point exceptions and setsVML_STATUS_OVERFLOWif an input vector argument element is finite and the corresponding result vector element value is infinite.
- Underflow
- The function raises underflow and inexact floating-point exceptions and setsVML_STATUS_UNDERFLOWif a result vector element value is subnormal or zero, and different from the corresponding input vector argument element.
Even though underflow or overflow can
occur, the returned value is independent of the current rounding
direction mode.