nexttoward

计算x在y方向的下个浮点数。

接口定义

C interface：

float nexttowardf(float x, long double y);

double nexttoward(double x, long double y);

参数

参数名	类型	描述	输入/输出
x	在nexttowardf中，x是单精度浮点类型。在nexttoward中，x是双精度浮点类型。	表示输入数据的浮点值。	输入
y	在nexttowardf中，y是long double浮点类型。在nexttoward中，y是long double浮点类型。	表示输入数据的浮点值。	输入

返回值

返回x的在y方向上的下一个浮点值。

输入x=y，返回x。
输入x或者y等于nan，返回nan。

依赖

C: "km.h"

示例

C interface：

    // typical usage
    double x1 = 1.0, x2 = 1.0;
    double y1 = 1.0, y2 = 1.1;
    double z1 = 1.0, z2 = 0.9;
    // special handling
    double e = INFINITY, f = -INFINITY, g = NAN;
    // print result
    printf("\t/*\n");
    printf("\t * nexttoward(1.0, 1.0) = %a\n", nexttoward(x1, (long double)y1));
    printf("\t * nexttoward(1.0, 1.1) = %a\n", nexttoward(y1, (long double)y2));
    printf("\t * nexttoward(1.0, 0.9) = %a\n", nexttoward(z1, (long double)z2));
    printf("\t * nexttoward(INFINITY, 0) = %a\n", nexttoward(e, 0.0));
    printf("\t * nexttoward(-INFINITY, 1.0) = %a\n", nexttoward(f, x1));
    printf("\t * nexttoward(NAN, 1.0) = %a\n", nexttoward(g, x1));
    printf("\t * nexttoward(NAN, INFINITY) = %a\n", nexttoward(g, e));
    printf("\t */\n");
    return 0;
    /*
     * nexttoward(1.0, 1.0) = 0x1p+0
     * nexttoward(1.0, 1.1) = 0x1.0000000000001p+0
     * nexttoward(1.0, 0.9) = 0x1.fffffffffffffp-1
     * nexttoward(INFINITY, 0) = 0x1.fffffffffffffp+1023
     * nexttoward(-INFINITY, 1.0) = -0x1.fffffffffffffp+1023
     * nexttoward(NAN, 1.0) = nan
     * nexttoward(NAN, INFINITY) = nan
     */

父主题： 杂项函数