v?NextAfter

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

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

vhNextAfter ( n , a , b , y );

vhNextAfterI(n, a, inca, b, incb, y, incy);

vmhNextAfter ( n , a , b , y , mode );

vmhNextAfterI(n, a, inca, b, incb, y, incy, mode);

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 _Float16* for `vhNextAfter` const float* for `vsNextAfter` const _Float16* for `vmhNextAfter` 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 (Sets a new mode for VM functions according to the mode parameter and stores the previous VM mode to oldmode.) for possible values and their description.

Output Parameters

Name	Type	Description
`y`	_Float16* for `vhNextAfter` float* for `vsNextAfter` _Float16* for `vmhNextAfter` 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 overﬂow and inexact ﬂoating-point exceptions and sets VML_STATUS_OVERFLOW if an input vector argument element is ﬁnite and the corresponding result vector element value is inﬁnite.

Underflow

The function raises underﬂow and inexact ﬂoating-point exceptions and sets VML_STATUS_UNDERFLOW if a result vector element value is subnormal or zero, and different from the corresponding input vector argument element.

Even though underﬂow or overﬂow can occur, the returned value is independent of the current rounding direction mode.

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

v?NextAfter

Syntax

Include Files

Input Parameters

Output Parameters

Description