Стандартная библиотека C++<numbers>

До C++20 мы обычно писали математические константы так:

const double PI = 3.14159265358979323846;

Проблема совершенно очевидна:Точность задавалась произвольно, непоследовательно, была подвержена ошибкам и небезопасна с точки зрения типов./p>

В C++20 официально появился#include <numbers>, предоставляющий стандартизированный набор математических констант, точность и корректность типов которых гарантируются компилятором.

std::numbersЭто модуль стандартной библиотеки, представленный в C++20, в основном используемый для предоставления набора часто используемых математических констант, служащий стандартным хранилищем математических и физических констант.

std::numbersНаходится в<numbers>в заголовочном файле и содержит множество математических констант, охватывая такие распространённые константы, как пи, основание натуральных логарифмов, золотое сечение и т. д.

Использование этих констант в C++ может повысить читаемость кода, точность и эффективность, избегая повторных определений и ручного ввода значений констант.

std::numbersПреимущества по сравнению с традиционным написанием:

Измерение Традиционный подход <numbers>
Precision Нестандартные Стандартная высокая точность
Type Фиксированные Автоматическое согласование
Читаемость Среднее Ясная семантика
Константа времени компиляции Не обязательно Определённо
Стандартизация Плохо Уровень стандартной библиотеки

Константы, содержащиеся в модуле 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Логарифм e по основанию 2 (log₂(e))1.4426950408889634
log10e_vЛогарифм e по основанию 10 (log₁₀(e))0.4342944819032518
pi_vМатематическая константа π (пи)3.141592653589793
inv_pi_v1/π (величина, обратная π)0.318309886183121
inv_sqrtpi_v1/√π (величина, обратная квадратному корню из π)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_v1/√3 (величина, обратная квадратному корню из 3)0.5773502691896257
egamma_vПостоянная Эйлера — Маскерони γ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

Эти константы и шаблоны переменных охватывают часто используемые математические константы, такие как pi, основание натурального логарифма, золотое сечение, и предоставляют варианты точности через шаблоны переменных разных типов, таких как float, double и long double.

Пример

#include <iostream>
#include <iomanip>
#include <numbers>
#include <cmath> // для стандартных математических функций sin, cos, log и т. д.

using namespace std;

int main()
{
    // Использовать константы типа double по умолчанию
    cout << fixed << setprecision(15); // Установить для всего вывода 15 знаков после десятичной точки

    // Вывести значение π (pi)
    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;

    // Вывести значение log2e, логарифма e по основанию 2
    cout << "Значение log2e, логарифма e по основанию 2, равно: " << numbers::log2e << endl;

    // Вывести значение log10e, логарифма e по основанию 10
    cout << "Значение log10e, логарифма e по основанию 10, равно: " << 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>;  // Использовать pi типа float
    cout << "\nИспользовать pi типа float: " << setprecision(7) << pi_f << endl; // Вывести 7 знаков после запятой
   
    long double pi_ld = numbers::pi_v<long double>;  // Использовать pi типа long double
    cout << "Использовать pi типа long double: " << 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>наиболее часто используемые константы; код можно скомпилировать и запустить напрямую. Не забудьте добавить стандартный параметр-std=c++20:

g++ -std=c++20 main.cpp -o main

Пример 1: Базовое использование

Вычисление площади / длины окружности круга с использованием π:

Пример

#include <iostream>
#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;  // Использовать π двойной точности напрямую
    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 — это версия pow для long double
    cout << "Площадь круга с высокой точностью: " << area_ld << endl;  // Выводит более точное значение 78.53981633974483...

    return 0;
}

Пример 2: Константа e

Натуральная константа e и экспоненциальные вычисления:

Пример

#include <iostream>
#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); // Вычислить e^2 с использованием numbers::e
    cout << "e^2 = " << exp_result << endl;          // Вывод: 7.38906
    cout << "e^2 (прямое вычисление) = " << exp_result_direct << endl;  // Результаты согласуются

    return 0;
}

Пример 3: Золотое сечение

Применение золотого сечения φ:

Пример

#include <iostream>
#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 <iostream>
#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;
}
Другие расширения