std::midpoint

 

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)

 

ヘッダ <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 の中点を計算します。

1) このオーバーロードは、 T は bool 以外の算術型である場合にのみ、オーバーロード解決に参加します。

2) このオーバーロードは、 T はオブジェクト型である場合にのみ、オーバーロード解決に参加します。 T は不完全型である場合、このオーバーロードは ill-formed です。

引数

a, b

-

整数、浮動小数点、またはポインタの値

戻り値

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