The lrint functions (C99) - lrint, lrintf, lrintl

その時点の丸め方向に従って，引数を最も近い整数値に丸めます．

lrint (C99)

#include <math.h>

long lrint(
    double x
);

lrint 関数は，その時点の丸め方向に従って double 型の引数 x を最も近い整数値に丸め，結果を long 型で返します．

lrintf (C99)

#include <math.h>

long lrintf(
    float x
);

lrintf 関数は，その時点の丸め方向に従って float 型の引数 x を最も近い整数値に丸め，結果を long 型で返します．

lrintl (C99)

#include <math.h>

long lrintl(
    long double x
);

lrintl 関数は，その時点の丸め方向に従って long double 型の引数 x を最も近い整数値に丸め，結果を long 型で返します．

lrint，lrintf，lrintl 関数が丸めた値が返却値の型の範囲外になった場合の結果は未規定です．また，x の絶対値が大きすぎる場合には値域エラー (range error) が発生することがあります．

戻り値

  • 丸めた整数値

C言語サンプルプログラム

以下に lrint 関数を使用したサンプルプログラムを示します．

/* header files */
#include <stdio.h>
#include <stdlib.h>
#include <fenv.h>
#include <math.h>

/* main */
int main(void) {
    long downward, upward;

    /* 負の無限大の方向へ丸めるように設定 */
    if (fesetround(FE_DOWNWARD) != 0) {
        fprintf(stderr, "error.");
        return EXIT_FAILURE;
    }

    /* 丸め */
    downward = lrint(0.51);
    printf("負の無限大の方向: %ld\n", downward);

    /* 正の無限大の方向へ丸めるように設定 */
    if (fesetround(FE_UPWARD) != 0) {
        fprintf(stderr, "error.");
        return EXIT_FAILURE;
    }

    /* 丸め */
    upward = lrint(0.51);
    printf("正の無限大の方向: %ld\n", upward);

    return EXIT_SUCCESS;
}

実行例

サンプルプログラムの実行結果は以下のようになります．

負の無限大の方向: 0
正の無限大の方向: 1