std::div, std::ldiv, std::lldiv

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

数値演算ライブラリ

一般的な数学関数

数学の特殊関数 (C++17)

数学定数 (C++20)

浮動小数点環境 (C++11)

複素数

数値配列

擬似乱数生成

コンパイル時有理数算術 (C++11)

数値演算アルゴリズム

gcd (C++17)

lcm (C++17)

補間

midpoint (C++20)

lerp (C++20)

汎用の数値演算

iota (C++11)

accumulate

inner_product

adjacent_difference

partial_sum

reduce (C++17)

transform_reduce (C++17)

inclusive_scan (C++17)

exclusive_scan (C++17)

transform_inclusive_scan (C++17)

transform_exclusive_scan (C++17)

ビット操作

bit_cast (C++20)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

一般的な数学関数

関数
基本的な演算
abs(int)labsllabsimaxabs (C++11) abs(float)fabs divldivlldivimaxdiv (C++11) fmod	remainder (C++11) remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
指数関数
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
冪関数
sqrt cbrt (C++11)	hypot (C++11) pow
三角関数と双曲線関数
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)

誤差関数とガンマ関数
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)
最も近い整数
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
浮動小数点操作関数
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
分類および比較
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
マクロ定数
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) INFINITY (C++11) NAN (C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

<tbody> </tbody>

ヘッダ <cstdlib> で定義
std::div_t div( int x, int y );	(1)
std::ldiv_t div( long x, long y );	(2)
std::lldiv_t div( long long x, long long y );	(3)	(C++11以上)
std::ldiv_t ldiv( long x, long y );	(4)
std::lldiv_t lldiv( long long x, long long y );	(5)	(C++11以上)
ヘッダ <cinttypes> で定義
std::imaxdiv_t div( std::intmax_t x, std::intmax_t y );	(6)	(C++11以上)
std::imaxdiv_t imaxdiv( std::intmax_t x, std::intmax_t y );	(7)	(C++11以上)

分子 x を分母 y で割った商と余りの両方を計算します。

商は小数部を破棄した (ゼロに向かって切り捨てた) 代数的な商です。 余りは quot * y + rem == x が成り立つように計算されます。	(C++11未満)
商は式 x/y の結果です。 余りは式 x%y の結果です。	(C++11以上)

引数

x, y

-

整数値

戻り値

余りと商の両方が対応する型 (ぞれぞれ int, long, long long, std::imaxdiv_t) のオブジェクトとして表現可能な場合は、以下のように定義される型 std::div_t, std::ldiv_t, std::lldiv_t, std::imaxdiv_t のオブジェクトとしてその両方を返します。

std::div_t

struct div_t { int quot; int rem; };

または

struct div_t { int rem; int quot; };

std::ldiv_t

struct ldiv_t { long quot; long rem; };

または

struct ldiv_t { long rem; long quot; };

std::lldiv_t

struct lldiv_t { long long quot; long long rem; };

または

struct lldiv_t { long long rem; long long quot; };

std::imaxdiv_t

struct imaxdiv_t { std::intmax_t quot; std::intmax_t rem; };

または

struct imaxdiv_t { std::intmax_t rem; std::intmax_t quot; };

余りまたは商のいずれかが表現できない場合、動作は未定義です。

ノート

C++11 までは、いずれかの被演算子が負の場合、組み込みの除算および剰余演算子における商の丸め方向と余りの符号は処理系定義でしたが、 std::div では well-defined でした。

多くのプラットフォームでは単一の CPU 命令で商と余りの両方を取得でき、この関数はそれを活用するかもしれません。 とはいえ、コンパイラは一般的に、近接する / および % を、適切な場合はマージすることができます。

例

Run this code

#include <string>
#include <cmath>
#include <cstdlib>
#include <iostream>

std::string itoa(int n, int base)
{
    std::string buf;
    std::div_t dv{}; dv.quot = n;
    do {
        dv = std::div(dv.quot, base);
        buf += "0123456789abcdef"[std::abs(dv.rem)];  // string literals are arrays
    } while(dv.quot);
    if(n<0) buf += '-';
    return {buf.rbegin(), buf.rend()};
}

int main()
{
    std::cout << itoa(12345, 10) << '\n'
              << itoa(-12345, 10) << '\n'
              << itoa(65535, 16) << '\n';
}

出力:

12345
-12345
ffff

関連項目

fmodfmodffmodl (C++11)(C++11)	浮動小数点除算の余りを計算します (関数)
remainderremainderfremainderl (C++11)(C++11)(C++11)	除算の符号付きの余りを計算します (関数)
remquoremquofremquol (C++11)(C++11)(C++11)	除算の下位3ビットと符号付きの余りを計算します (関数)
div の C言語リファレンス