C++のremainder()関数の使い方と動作を解説

C++のremainder()関数とは

この記事では、C++のremainder()メソッドの機能について詳しく解説します。remainder()関数は、分子を分母で割った浮動小数点の剰余（余り）を計算するために使用されます。

remainder(x, y)は、以下のような式で表されます。

remainder(x, y) = x − rquote * y

ここで、rquoteはx/yの値であり、最も近い整数値に丸められた値です。つまり、通常の剰余演算とは異なり、結果が−y/2〜+y/2の範囲に収まるように計算されるのが特徴です。

この関数は、double型、float型、long double型の2つの引数を受け取り、引数として与えられたものと同じ型の剰余を返します。第1引数が分子、第2引数が分母に相当します。

remainder()とfmod()の違い

なお、C++には似たような関数としてfmod()がありますが、両者は丸め方に違いがあります。fmod()は商をゼロ方向へ切り捨てるのに対し、remainder()は商を最も近い整数に丸めるため、結果が負になる場合があります。

サンプルコード

以下のコードは、remainder()関数の基本的な使用例です。正の数同士、負の数を含むケース、そして分母が0の場合の3つのパターンを確認できます。

#include <iostream>
#include <cmath>
using namespace std;

int main() {
    double x = 14.5, y = 4.1;
    double res = remainder(x, y);
    cout << "Remainder of " << x << "/" << y << " is: " << res << endl;

    x = -34.50;
    y = 4.0;
    res = remainder(x, y);
    cout << "Remainder of " << x << "/" << y << " is: " << res << endl;

    x = 65.23;
    y = 0;
    res = remainder(x, y);
    cout << "Remainder of " << x << "/" << y << " is: " << res << endl;
}

実行結果

Remainder of 14.5/4.1 is: -1.9
Remainder of -34.5/4 is: 1.5
Remainder of 65.23/0 is: nan

結果の解説

• 14.5 / 4.1 の場合： 商は約3.54で、最も近い整数である4に丸められるため、14.5 − 4 × 4.1 = −1.9 となります。
• -34.5 / 4 の場合： 商は-8.625で、最も近い整数である-9に丸められるため、-34.5 − (-9) × 4 = 1.5 となります。
• 分母が0の場合： ゼロ除算となるため、結果はNaN（Not a Number）が返されます。

このように、remainder()関数を使うことで、IEEE 754規格に準拠した剰余計算を簡単に行うことができます。数値計算や信号処理など、正確な剰余演算が必要な場面で活用するとよいでしょう。