The llround functions (C99) - llround, llroundf, llroundl

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

llround (C99)

#include <math.h>

long long llround(
    double x
);

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

llroundf (C99)

#include <math.h>

long long llroundf(
    float x
);

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

llroundl (C99)

#include <math.h>

long long llroundl(
    long double x
);

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

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

戻り値

  • 丸めた整数値

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

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

/* 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 long y1, y2, y3, y4, y5;

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

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

    return EXIT_SUCCESS;
}

実行例

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

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

Cプログラマの必読書

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

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

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


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

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