v?NextAfter

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 3/31/2023

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-61926A68-EB65-4BCA-BDCF-7D4EDC98B4FF

View Details

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`.

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 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.

Parent topic: Miscellaneous VM Functions

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