最終更新日時(UTC): 2024年06月11日 13時45分38秒
Akira Takahashi が更新

履歴 編集

function template
<utility>

# std::cmp_less(C++20)

    namespace std {
      template <class T, class U>
      constexpr bool cmp_less(T t, U u) noexcept;
    }

## 概要

整数に対して安全に、左辺が右辺より小さいかを比較（`t < u`）する。

この関数は、型`T`と型`U`がそれぞれ符号付き整数と符号なし整数のどちらであったとしても、安全に比較できる関数である。以下のように符号付き整数のインデックス変数と符号なし整数の配列要素数の比較によってコンパイラに警告が出力されてしまうような状況で使用できる：

    std::vector<X> v;

    // 警告：式`i < v.size()`で、符号付き整数と符号なし整数の間で比較しようとした
    for (int i = 0; i < v.size(); ++i) {}

    // OK
    for (int i = 0; cmp_less(i, v.size()); ++i) {}

## 適格要件

- 型`T`と型`U`はどちらも、符号なし整数型もしくは符号付き整数型であること

## 効果

以下と等価：

    using UT = make_unsigned_t<T>;
    using UU = make_unsigned_t<U>;
    if constexpr (is_signed_v<T> == is_signed_v<U>)
      return t < u;
    else if constexpr (is_signed_v<T>)
      return t < 0 ? true : UT(t) < u;
    else
      return u < 0 ? false : t < UU(u);

## 例外

投げない

## 例

    #include <iostream>
    #include <utility>

    int main() {
      std::cout << std::boolalpha;

      // 符号付き整数型同士の比較
      std::cout << std::cmp_less(1, 2) << std::endl;

      // 符号なし整数型同士の比較
      std::cout << std::cmp_less(1u, 2u) << std::endl;

      // 符号付き整数型と符号なし整数型の比較
      std::cout << std::cmp_less(1, 2u) << std::endl;
      std::cout << std::cmp_less(1u, 2) << std::endl;
    }

### 出力

    true
    true
    true
    true

## バージョン

### 言語

- C++20

## 処理系

- Clang:
- GCC: 10.1 ✅
- Visual C++: 2019 Update 7 ✅

## 関連項目

- C++23 (符号付き)`size_t`リテラルのためのサフィックス
- `std::ssize()`

## 参照

- P0586R2 Safe integral comparisons