std:: midpoint

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

、$タグ内のテキストは翻訳していません\; -\; C++固有の用語（Parameters、Return\; value、Exceptions、Notes、Example、References、See\; also）は原文のまま保持しました\; -\; 番号付けと書式は完全に保持されています$

パラメータ

戻り値

例外

例外を送出しません。

注記

オーバーロード (2) は、一般的なプラットフォームでは return a + ( b - a ) / 2 ; として単純に実装できます。しかし、このような実装は移植性が保証されません。なぜなら、要素数が PTRDIFF_MAX より大きい配列を作成可能なプラットフォームが存在する可能性があり、 b - a が未定義動作を引き起こす可能性があるためです。たとえ b と a が同じ配列内の要素を指している場合でも同様です。

例

#include <cstdint>
#include <iostream>
#include <limits>
#include <numeric>
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\n";
    auto on_pointers = [](int i, int j)
    {
        char const* text = "0123456789";
        char const* p = text + i;
        char const* q = text + j;
        std::cout << "std::midpoint('" << *p << "', '" << *q << "'): '"
                  << *std::midpoint(p, q) << "'\n";
    };
    on_pointers(2, 4);
    on_pointers(2, 5);
    on_pointers(5, 2);
    on_pointers(2, 6);
}

a: 4294967295
b: 4294967293
Incorrect (overflow and wrapping): 2147483646
Correct: 4294967294
std::midpoint('2', '4'): '3'
std::midpoint('2', '5'): '3'
std::midpoint('5', '2'): '4'
std::midpoint('2', '6'): '4'

参考文献

関連項目