v?nextafter

Return the next representable value after x in the direction of y. The inputs are vectors.

Interface Definition

C interface:

void vsnextafter(const int len, const float* src1, const float* src2, float* dst);

void vdnextafter(const int len, const double* src1, const double* src2, double* dst);

Parameters

Parameter	Type	Description	Input/Output
len	Integer	Number of elements in the input vector. If len ≤ 0, an invalid parameter error is reported and the function returns.	Input
src1	Single-precision floating-point type for vsnextafter Double-precision floating-point type for vdnextafter	Input vector src1 with length len. If the pointer is null, a null pointer error is reported and the function returns.	Input
src2	Single-precision floating-point type for vsnextafter Double-precision floating-point type for vdnextafter	Input vector src2 with length len. If the pointer is null, a null pointer error is reported and the function returns.	Input
dst	Single-precision floating-point type for vsnextafter Double-precision floating-point type for vdnextafter	Output vector dst with length len. If the pointer is null, a null pointer error is reported and the function returns.	Output

Return Value

The next representable value after x in the direction of y is returned.

For special values, see the following table.

Input Value 1 (src1)	Input Value 2 (src2)	Output Value (dst)
nan	!= nan	nan
!= nan	nan	nan
nan	nan	nan
+inf	-inf	0x7f7fffff(float)
+inf	-inf	0x7fefffffffffffff(double)
-inf	+inf	0xff7fffff(float)
-inf	+inf	0xffefffffffffffff(double)
+inf	+inf	+inf
-inf	-inf	-inf

Dependencies

C: "kvml.h"

Examples

C interface:

    int i, len = 8; 
    float src1[8] = {-1.5f, -0.0f, 0.0f, 1.0f, 1.5f, -INFINITY, INFINITY, NAN};
    float src2[8] = {-1.1f, 0.0f, +0.0f, -1.0f, -1.5f, +INFINITY, -INFINITY, -NAN}; 
    float* dst = (float*)malloc(sizeof(float) * len); 
    if (dst == NULL) { 
        printf("Malloc Failed!\n"); 
        return 0;
    }
    vsnextafter(len, src1, src2, dst);

    /** 
     *  Output dst: 
     *     -1.500000 0.000000 0.000000 1.000000 1.500000 -340282346638528859811704183484516925440.000000 340282346638528859811704183484516925440.000000 nan
     */

Parent topic: Function Syntax