std::midpoint

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

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

アルゴリズムライブラリ

数値演算ライブラリ

入出力ライブラリ

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

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

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

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

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

技術仕様書

 

数値演算ライブラリ

一般的な数学関数

特殊な数学関数 (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)

ispow2 (C++20)

ceil2 (C++20)

floor2 (C++20)

log2p1 (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)

 

ヘッダ <numeric> で定義
template< class T > constexpr T midpoint(T a, T b) noexcept;	(1)	(C++20以上)
template< class T > constexpr T* midpoint(T* a, T* b);	(2)	(C++20以上)

整数、浮動小数点、またはポインタ a と b の中点を計算します。

引数

a, b	-	整数、浮動小数点、またはポインタの値
型の要件
- オーバーロード (1) の場合、 T は bool 以外の算術型でなければなりません。
- オーバーロード (2) の場合、 T は完全オブジェクト型でなければなりません。

戻り値

1) a と b の和の半分。 オーバーフローは発生しません。 a と b が整数型で、その和が奇数の場合、結果は a に向かって丸められます。 a と b が浮動小数点型の場合、不正確な演算は多くとも1回しか発生しません。

2) a と b が、それぞれ、 (ポインタ算術の目的のために) 同じ配列オブジェクト x の x[i] と x[j] を指している場合、 x[i+(j-i)/2] を指すポインタを返します (除算はゼロに向かって丸められます)。 a と b が同じ配列オブジェクトの要素を指していない場合、動作は未定義です。

例外

何も例外を投げません。

例

Run this code

#include <cstdint>
#include <limits>
#include <numeric>
#include <iostream>
 
int main()
{
    std::uint32_t a = std::numeric_limits<std::uint32_t>::max();
    std::uint32_t b = std::numeric_limits<std::uint32_t>::max() - 2;
 
    std::cout << "a: " << a << '\n'
              << "b: " << b << '\n'
              << "Incorrect (overflow and wrapping): " << (a + b) / 2 << '\n'
              << "Correct: " << std::midpoint(a, b) << '\n';
}

出力:

a: 4294967295
b: 4294967293
Incorrect (overflow and wrapping): 2147483646
Correct: 4294967294