The lround functions (C99) - lround, lroundf, lroundl

引数を最も近い整数値に丸めます．引数がちょうど中間にある場合は，その時点の丸め方向にかかわらず 0 から遠い方向を選びます．

lround (C99)

#include <math.h>

long lround(
    double x
);

lround 関数は double 型の引数 x を最も近い整数値に丸め，結果を long 型で返します．引数がちょうど中間にある場合は，その時点の丸め方向にかかわらず 0 から遠い方向を選びます．

lroundf (C99)

#include <math.h>

long lroundf(
    float x
);

lroundf 関数は, float 型の引数 x を最も近い整数値に丸め，結果を long 型で返します．引数がちょうど中間にある場合は，その時点の丸め方向にかかわらず 0 から遠い方向を選びます．

lroundl (C99)

#include <math.h>

long lroundl(
    long double x
);

lroundl 関数は, long double 型の引数 x を最も近い整数値に丸め，結果を long 型で返します．引数がちょうど中間にある場合は，その時点の丸め方向にかかわらず 0 から遠い方向を選びます．

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

戻り値

  • 丸めた整数値

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

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

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

/* main */
int main(void) {
    double x1 = 5.0001, x2 = -5.0001;
    double x3 = 0.0;
    double x4 = 5.5000, x5 = -5.5000;
    long y1, y2, y3, y4, y5;

    y1 = lround(x1);
    y2 = lround(x2);
    y3 = lround(x3);
    y4 = lround(x4);
    y5 = lround(x5);

    printf("lround(%.4f) = %ld\n", x1, y1);
    printf("lround(%.4f) = %ld\n", x2, y2);
    printf("lround(%.4f) = %ld\n", x3, y3);
    printf("lround(%.4f) = %ld\n", x4, y4);
    printf("lround(%.4f) = %ld\n", x5, y5);

    return EXIT_SUCCESS;
}

実行例

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

lround(5.0001) = 5
lround(-5.0001) = -5
lround(0.0000) = 0
lround(5.5000) = 6
lround(-5.5000) = -6

Cプログラマの必読書

たくさんあるC言語関連の書籍の中でも特に役に立った本です．よかったら参考にしてみてください．

C実践プログラミング 第3版

C言語の実践的参考書．少々値段は張りますが初心者を脱しようとしている人は絶対に読むべきです．
文法だけでなく，コーディングスタイルやデバッグなど文字通り「実践的」なことが書かれているので非常にためになります． オライリーの本は，読みにくい本が多いのですが本書はとても読みやすくオススメです．


C言語ポインタ完全制覇 (標準プログラマーズライブラリ)

ポインタの解説書としては最高の書籍です．
この1冊でポインタを完全に理解することができます．全くの初学者が読むには敷居が高いですが，入門書を読み終えた後に読むと非常に有益です．