# std::numeric_limits<T>::min

< cpp‎ | types‎ | numeric limits

定义于头文件 `<limits>` |  |
static T min() throw(); |  | (C++11 前)
static constexpr T min() noexcept; |  | (C++11 起)

返回数值类型 `T` 可表示的最小有限值。

对于有非正规的浮点类型， `min` 返回最小正正规值。注意此行为可能是非预期的，特别是在与 `min` 对整数类型的行为比较时。为找到没有比它更小的值的值，请用 `numeric_limits::lowest` 。

`min` 仅对有界类型和无界无符号类型意义，即表示负值的无限集的类型无有意义的最小值。

### 返回值

`T` | std::numeric_limits<T>::min()
/* non-specialized */ | `T()`
bool | false
char | CHAR_MIN
signed char | SCHAR_MIN
unsigned char | ​0​
wchar_t | WCHAR_MIN
char8_t (C++20) | ​0​
char16_t (C++11) | ​0​
char32_t (C++11) | ​0​
short | SHRT_MIN
unsigned short | ​0​
int | INT_MIN
unsigned int | ​0​
long | LONG_MIN
unsigned long | ​0​
long long (C++11) | LLONG_MIN
unsigned long long (C++11) | ​0​
float | FLT_MIN
double | DBL_MIN
long double | LDBL_MIN

### 示例

演示以 typedef 类型使用，及整数和浮点类型间结果符号的差异

    #include <limits>
    #include <cstddef>
    #include <iostream>

    int main()
    {
        std::cout
            << "short: " << std::dec << std::numeric_limits<short>::min()
            << " or " << std::hex << std::showbase
            << std::numeric_limits<short>::min() << '\n'

            << "int: " << std::dec << std::numeric_limits<int>::min() << std::showbase
            << " or " << std::hex << std::numeric_limits<int>::min() << '\n' << std::dec

            << "ptrdiff_t: " << std::numeric_limits<std::ptrdiff_t>::min() << std::showbase
            << " or " << std::hex << std::numeric_limits<std::ptrdiff_t>::min() << '\n'

            << "float: " << std::numeric_limits<float>::min()
            << " or " << std::hexfloat << std::numeric_limits<float>::min() << '\n'

            << "double: " << std::defaultfloat << std::numeric_limits<double>::min()
            << " or " << std::hexfloat << std::numeric_limits<double>::min() << '\n';
    }

可能的输出：

    short: -32768 or 0x8000
    int: -2147483648 or 0x80000000
    ptrdiff_t: -9223372036854775808 or 0x8000000000000000
    float: 1.17549e-38 or 0x1p-126
    double: 2.22507e-308 or 0x1p-1022

### 参阅

lowest [静态] (C++11) | 返回给定类型的最低有限值 (公开静态成员函数)
denorm_min [静态] | 返回给定浮点类型的最小正非正规值 (公开静态成员函数)
max [静态] | 返回给定类型的最大有限值 (公开静态成员函数)