lround、 lroundf、 lroundl、 llround、 llroundf、 llroundl

浮動小数点値を最も近い整数に丸めます。

構文

long lround(
   double x
);
long lround(
   float x
);  // C++ only
long lround(
   long double x
);  // C++ only
long lroundf(
   float x
);
long lroundl(
   long double x
);
long long llround(
   double x
);
long long llround(
   float x
);  // C++ only
long long llround(
   long double x
);  // C++ only
long long llroundf(
   float x
);
long long llroundl(
   long double x
);
#define lround(X) // Requires C11 or higher

パラメーター

x
丸める浮動小数点値。

戻り値

lround 関数、および llround 関数は、long に最も近い long long 整数、または x 整数を返します。 中間の値は、浮動小数点丸めモードの設定にかかわらず、ゼロから離れる方向に丸められます。 エラーの戻り値はありません。

入力	SEH 例外	_matherr 例外
± QNaN、IND	なし	_DOMAIN

解説

C++ ではオーバーロードが許可されるため、float値とlong double値を受け取って返すlroundまたはllroundオーバーロードを呼び出すことができます。 C プログラムでは、<tgmath.h> マクロを使用してこの関数を呼び出す場合を除き、lroundし、常にdoubleを取得して返llround。

<tgmath.h>lround() マクロを使用する場合は、引数の型によって、この関数のどのバージョンが選択されるかが決定されます。 詳細については、「ジェネリック型数値演算」を参照してください。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

要件

ルーチンによって返される値	必須ヘッダー
lround、 lroundf、 lroundl、 llround、 llroundf、 llroundl	<math.h>
lround マクロ	<tgmath.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// crt_lround.c
// Build with: cl /W4 /Tc crt_lround.c
// This example displays the rounded results of
// the floating-point values 2.499999, -2.499999,
// 2.8, -2.8, 3.5 and -3.5.

#include <math.h>
#include <stdio.h>

int main( void )
{
   double x = 2.499999;
   float y = 2.8f;
   long double z = 3.5L;

   printf("lround(%f) is %d\n", x, lround(x));
   printf("lround(%f) is %d\n", -x, lround(-x));
   printf("lroundf(%f) is %d\n", y, lroundf(y));
   printf("lroundf(%f) is %d\n", -y, lroundf(-y));
   printf("lroundl(%Lf) is %d\n", z, lroundl(z));
   printf("lroundl(%Lf) is %d\n", -z, lroundl(-z));
}

lround(2.499999) is 2
lround(-2.499999) is -2
lroundf(2.800000) is 3
lroundf(-2.800000) is -3
lroundl(3.500000) is 4
lroundl(-3.500000) is -4

関連項目

数値演算と浮動小数点のサポート
ceil、 ceilf、 ceill
floor、 floorf、 floorl
fmod, fmodf
lrint、 lrintf、 lrintl、 llrint、 llrintf、 llrintl
round、 roundf、 roundl
nearbyint、 nearbyintf、 nearbyintl
rint、 rintf、 rintl