C++ 標準ライブラリ<numbers>
C++20 より前は、数学定数を通常次のように書いていました:
const double PI = 3.14159265358979323846;
問題は非常に明らかです:精度がその場しのぎで、統一されておらず、間違いやすく、型も安全ではありません。</p>
C++20 で正式に導入され#include <numbers>、標準化された数学定数の集合を提供し、コンパイラによって精度と型の正確性が保証されます。
std::numbersC++20 で導入された標準ライブラリモジュールであり、主に一般的な数学定数のセットを提供するために使用され、標準的な数学・物理定数のリポジトリです。
std::numbers位置し<numbers>ヘッダーファイル内にあり、多くの数学定数が含まれており、円周率、自然対数の底、黄金比などの一般的な定数を網羅しています。
C++ でこれらの定数を使用すると、コードの可読性、精度、効率が向上し、定数の再定義や手動入力の手間を避けることができます。
std::numbers従来の記述との比較による利点:
| 観点 | 従来の記述 | <numbers> |
|---|---|---|
| 精度 | 適当に書く | 標準の高精度 |
| 型 | 固定 | 自動的に一致 |
| 可読性 | 普通 | 意味が明確 |
| コンパイル時定数 | 必ずしもそうではない | 必ずそうである |
| 規範性 | 差 | 標準ライブラリレベル |
std::numbers モジュールに含まれる定数
std::numbers 名前空間には以下のメンバーが含まれます:
template<floating_point T> inline constexpr T e_v<T> // 自然常数e template<floating_point T> inline constexpr T log2e_v<T> // log2e template<floating_point T> inline constexpr T log10e_v<T> // log10e template<floating_point T> inline constexpr T pi_v<T> // 圆周率π template<floating_point T> inline constexpr T inv_pi_v<T> // 1/π template<floating_point T> inline constexpr T inv_sqrtpi_v<T> //1/根号π template<floating_point T> inline constexpr T ln2_v<T> // ln2 template<floating_point T> inline constexpr T ln10_v<T> // ln10 template<floating_point T> inline constexpr T sqrt2_v<T> //根号2 template<floating_point T> inline constexpr T sqrt3_v<T> //根号3 template<floating_point T> inline constexpr T inv_sqrt3_v<T> // 1/根号3 template<floating_point T> inline constexpr T egamma_v<T> // 欧拉常数γ template<floating_point T> inline constexpr T phi_v<T> // 黄金分割比Φ inline constexpr double e = e_v<double> inline constexpr double log2e = log2e_v<double> inline constexpr double log10e = log10e_v<double> inline constexpr double pi = pi_v<double> inline constexpr double inv_pi = pi_v<double> inline constexpr double inv_sqrtpi = pi_v<double> inline constexpr double ln2 = ln2_v<double> inline constexpr double ln10 = ln10_v<double> inline constexpr double sqrt2 = sqrt2_v<double> inline constexpr double sqrt3 = sqrt3_v<double> inline constexpr double inv_sqrt3 = sqrt3_v<double> inline constexpr double egamma = egamma_v<double> inline constexpr double phi = phi_v<double>
以下は std::numbers に含まれる定数のリストです:
| 定数/テンプレート名 | 説明 | 例の値(近似) |
|---|---|---|
e_v | 数学定数 e(自然対数の底) | 2.718281828459045 |
log2e_v | 2 を底とする e の対数(log₂(e)) | 1.4426950408889634 |
log10e_v | 10 を底とする e の対数(log₁₀(e)) | 0.4342944819032518 |
pi_v | 数学定数 π(円周率) | 3.141592653589793 |
inv_pi_v | 1/π(πの逆数) | 0.318309886183121 |
inv_sqrtpi_v | 1/√π(πの平方根の逆数) | 0.5641895835477563 |
ln2_v | 2 の自然対数(ln(2)) | 0.6931471805599453 |
ln10_v | 10 の自然対数(ln(10)) | 2.302585092994046 |
sqrt2_v | √2(ルート2) | 1.4142135623730951 |
sqrt3_v | √3(ルート3) | 1.7320508075688772 |
inv_sqrt3_v | 1/√3(ルート3の逆数) | 0.5773502691896257 |
egamma_v | オイラー=マスケローニ定数 γ(Euler-Mascheroni constant) | 0.5772156649015329 |
phi_v | 黄金比 Φ((1 + √5) / 2) | 1.618033988749895 |
e | 定数 e(次と同等:e_v<double>) | 2.718281828459045 |
log2e | 定数 log₂(e)(次と同等:log2e_v<double>) | 1.4426950408889634 |
log10e | 定数 log₁₀(e)(次と同等:log10e_v<double>) | 0.4342944819032518 |
pi | 定数 π(次と同等:pi_v<double>) | 3.141592653589793 |
inv_pi | 定数 1/π(次と同等:inv_pi_v<double>) | 0.318309886183121 |
inv_sqrtpi | 定数 1/√π(次と同等:inv_sqrtpi_v<double>) | 0.5641895835477563 |
ln2 | 定数 ln(2)(次と同等:ln2_v<double>) | 0.6931471805599453 |
ln10 | 定数 ln(10)(次と同等:ln10_v<double>) | 2.302585092994046 |
sqrt2 | 定数 √2(次と同等:sqrt2_v<double>) | 1.4142135623730951 |
sqrt3 | 定数 √3(次と同等:sqrt3_v<double>) | 1.7320508075688772 |
inv_sqrt3 | 定数 1/√3(次と同等:inv_sqrt3_v<double>) | 0.5773502691896257 |
egamma | 定数 γ(オイラー=マスケローニ定数)(次と同等:egamma_v<double>) | 0.5772156649015329 |
phi | 定数 黄金比 Φ(次と同等:phi_v<double>) | 1.618033988749895 |
これらの定数と変数テンプレートは、円周率、自然対数の底、黄金比など一般的な数学定数を網羅し、float、double、long double などの異なる型の変数テンプレートによって精度オプションを提供します。
例
#include <iomanip>
#include <numbers>
#include <cmath> // 標準数学関数 sin, cos, log などのために使用
using namespace std;
int main()
{
// デフォルトの double 型定数を使用
cout << fixed << setprecision(15); // すべての出力を小数点以下15桁に設定
// 円周率 π の値を出力
cout << "円周率 pi の値は: " << numbers::pi << endl;
// 自然対数の底 e の値を出力
cout << "自然定数 e の値は: " << numbers::e << endl;
// ルート2 (sqrt2) の値を出力
cout << "ルート2 (sqrt2) の値は: " << numbers::sqrt2 << endl;
// ルート3 (sqrt3) の値を出力
cout << "ルート3 (sqrt3) の値は: " << numbers::sqrt3 << endl;
// 黄金比 phi の値を出力
cout << "黄金比 phi の値は: " << numbers::phi << endl;
// オイラー=マスケローニ定数 egamma の値を出力
cout << "オイラー=マスケローニ定数 egamma の値は: " << numbers::egamma << endl;
// 1/π (inv_pi) の値を出力
cout << "1/π (inv_pi) の値は: " << numbers::inv_pi << endl;
// 1/√π (inv_sqrtpi) の値を出力
cout << "1/√π (inv_sqrtpi) の値は: " << numbers::inv_sqrtpi << endl;
// 2 を底とする e の対数 log2e の値を出力
cout << "2 を底とする e の対数 log2e の値は: " << numbers::log2e << endl;
// 10 を底とする e の対数 log10e の値を出力
cout << "10 を底とする e の対数 log10e の値は: " << numbers::log10e << endl;
// sin(π/2) の値を出力
cout << "sin(π/2) の値は: " << sin(numbers::pi / 2) << endl;
// cos(π) の値を出力
cout << "cos(π) の値は: " << cos(numbers::pi) << endl;
// ln(e) の値を出力
cout << "ln(e) の値は: " << log(numbers::e) << endl;
// 異なるデータ型の使用をデモする
float pi_f = numbers::pi_v<float>; // float 型の pi を使用
cout << "\nfloat 型の pi を使用: " << setprecision(7) << pi_f << endl; // 小数点以下7桁を出力
long double pi_ld = numbers::pi_v<long double>; // long double 型の pi を使用
cout << "long double 型の pi を使用: " << setprecision(21) << pi_ld << endl; // 小数点以下21桁を出力
// 異なる精度の値を計算
cout << "\nsin(π/2) を double で使用: " << sin(numbers::pi / 2) << endl;
cout << "sin(π/2) を float で使用: " << sin(static_cast<float>(numbers::pi) / 2) << endl;
cout << "sin(π/2) を long double で使用: " << sin(static_cast<long double>(numbers::pi) / 2) << endl;
return 0;
}
コードの解説:
フォーマット出力:
- 使用して
fixedとsetprecision()出力の小数点以下が固定桁数になるようにします。ここではデフォルトで小数点以下15桁を出力しますが、データ型ごとに異なる精度を設定することもできます。
一般的な数学関数の計算:
- 計算しました
sin(π/2)、cos(π)とln(e)などの一般的な数学関数を計算し、使用しますcmath内の関数(例:sin、cosとlog)を使用して、数学定数の使用方法を示します。
異なるデータ型の精度:
- 使用して
numbers::pi_v<float>とnumbers::pi_v<long double>異なる型の定数を示します。例えばfloatとlong double、異なる精度で出力できます。
異なる型を使用した計算:
- 計算の際に
sinは、異なる精度の型を使って計算する方法を示し、実演しましたfloat、doubleとlong double同じ数式での違いを示しました。
出力:
圆周率 pi 的值是: 3.141592653589793 自然常数 e 的值是: 2.718281828459045 根号2 (sqrt2) 的值是: 1.414213562373095 根号3 (sqrt3) 的值是: 1.732050807568877 黄金比例 phi 的值是: 1.618033988749895 欧拉-马歇罗尼常数 egamma 的值是: 0.5772156649015329 1/π (inv_pi) 的值是: 0.318309886183121 1/√π (inv_sqrtpi) 的值是: 0.5641895835477563 以 2 为底的 e 的对数 log2e 的值是: 1.4426950408889634 以 10 为底的 e 的对数 log10e 的值是: 0.4342944819032518 sin(π/2) 的值是: 1 cos(π) 的值是: -1 ln(e) 的值是: 1 使用 float 类型的 pi: 3.1415927 使用 long double 类型的 pi: 3.141592653589793238462643 sin(π/2) 使用 double: 1 sin(π/2) 使用 float: 1 sin(π/2) 使用 long double: 1
使用例
以下の例はカバーしています<numbers>最も一般的な定数をカバーしており、コードはそのままコンパイル・実行できます。標準パラメータを1つ追加するのを忘れないでください。-std=c++20:
g++ -std=c++20 main.cpp -o main
例1:基本使用
円周率 π で円の面積 / 周長を計算:
例
#include <numbers> // 数学定数を含む
#include <cmath> // powなどの数学関数を含む
using namespace std;
using namespace std::numbers; // 定数の呼び出しを簡略化(オプション)
int main() {
// 円の半径
double r = 5.0;
// 1. 円の周長を計算:2 * π * r
double circumference = 2 * pi * r; // double版のπを直接使用
cout << 半径が << r << の円周長: << circumference << endl; // 出力:31.4159
// 2. 円の面積を計算:π * r²
double area = pi * pow(r, 2);
cout << 半径が << r << の円面積: << area << endl; // 出力:78.5398
// 3. 高精度版(long double)
long double r_ld = 5.0L;
long double area_ld = pi_v<long double> * powl(r_ld, 2); // powlはlong double版のpow
cout << "高精度円面積:" << area_ld << endl; // より正確な78.53981633974483...を出力
return 0;
}
例2:定数 e
自然定数 e と指数計算:
例
#include <numbers>
#include <cmath>
using namespace std;
using namespace std::numbers;
int main() {
// 自然指数計算:e^x(exp関数はcmathの指数関数)
double x = 2.0;
double exp_result = exp(x); // 手動でe^2を計算
double exp_result_direct = pow(e, x); // numbers::eを使ってe^2を計算
cout << "e^2 = " << exp_result << endl; // 出力:7.38906
cout << "e^2(直接計算)= " << exp_result_direct << endl; // 結果は一致
return 0;
}
例3:黄金比
黄金比 φ の応用:
例
#include <numbers>
using namespace std;
using namespace std::numbers;
int main() {
// 黄金比:長さ/幅 = φ のとき黄金長方形
double width = 10.0;
double golden_height = width * phi; // 黄金長方形の高さ
cout << "幅が" << width << "の黄金長方形の高さ:" << golden_height << endl; // 出力:16.1803
// φの数学的定義を検証:φ = (1 + √5)/2
double phi_manual = (1 + sqrt(5.0)) / 2;
cout << "手動で計算した黄金比:" << phi_manual << endl; // numbers::phiと一致
return 0;
}
例4:浮動小数点型
異なる浮動小数点型への定数の適合:
例
#include <numbers>
#include <iomanip> // 出力精度を設定するため
using namespace std;
int main() {
// 高精度出力を設定(小数15桁を表示)
cout << fixed << setprecision(15);
// float版π(単精度)
float pi_float = std::numbers::pi_v<float>;
cout << "float版π:" << pi_float << endl; // 出力:3.141592741012573
// double版π(倍精度、デフォルト)
double pi_double = std::numbers::pi;
cout << "double版π:" << pi_double << endl; // 出力:3.141592653589793
// long double版π(高精度)
long double pi_long_double = std::numbers::pi_v<long double>;
cout << "long double版π:" << pi_long_double << endl; // より正確な3.1415926535897932385...を出力
return 0;
}