C++ 参考手册

位置：首页 > C++ 参考手册 >C++ 语言 > 扩充命名空间 std

扩充命名空间 std

向 std 添加声明

向 namespace std 或 std 中嵌套的任何命名空间添加声明或定义，除了下面提到的少数例外，都是未定义行为： 

#include <utility>
namespace std {
    // 向命名空间 std 添加函数：未定义行为
    pair<int, int> operator+(pair<int, int> a, pair<int, int> b) {
        return {a.first+b.first, a.second+b.second};
    }
}

添加模板特化

对于任何标准库类 (C++20 起)模板的模板特化，仅当其声明依赖于至少一个程序定义类型，且该特化满足原模板的所有要求时，才允许向命名空间 std 中添加，除非这种特化被禁止。 

// 获取主 std::hash 模板的声明。不容许我等自己声明它。
// 保证 <typeindex> 提供这种声明，包含它比 <functional> 低廉很多。
 
#include <typeindex> 
 
// 特化 std::hash 使得能以 MyType 为
// std::unordered_set 和 std::unordered_map 中的键
namespace std {
    template <> struct hash<MyType> {
      std::size_t operator()(const MyType& t) const { return t.hash(); }
    };
}
  • 声明标准库类模板的任何成员函数的完全特化是未定义行为
本节未完成
原因：小示例
  • 声明标准库类或类模板的任何成员函数模板的完全特化是未定义行为
本节未完成
原因：小示例
  • 声明标准库类或类模板的任何成员类模板的完全或部分特化是未定义行为。
本节未完成
原因：小示例
  • 声明任何标准库变量模板的完全特化或部分特化是未定义行为，除了显式允许的变量模板。
本节未完成
原因：小示例
(C++14 èµ·)
  • 对 float、double、long double 以外的类型特化 std::complex 是未指明的。
  • std::numeric_limits 的特化必须对主模板中所有声明为 static const (C++11 前)static constexpr (C++11 èµ·) 的成员进行定义，而且要使得它们能用作整型常量表达式。
  • std::atomic 的特化必须拥有被删除的复制构造函数，被删除的复制赋值运算符，及一个 constexpr 值构造函数。
(C++11 èµ·)
  • std::istreambuf_iterator 的特化必须有平凡复制构造函数、constexpr 默认构造函数，及平凡析构函数。
(C++17 前)
  • std::disable_sized_sentinel_for 、 std::ranges::disable_sized_range 、 std::ranges::enable_view 与 std::ranges::enable_borrowed_range 的特化必须可用于常量表达式并拥有 const bool 类型。而且
    • std::disable_sized_sentinel_for 可对无 cv 限定的非数组对象类型 S 与 I 特化，其中至少一者须为程序定义类型。
    • std::ranges::disable_sized_range 、 std::ranges::enable_view 与 std::ranges::enable_borrowed_range 可对无 cv 限定的程序定义类型特化。
(C++20 èµ·)

模板的显式实例化

对于标准库中定义的类 (C++20 起)模板的显式实例化，仅当其声明依赖于至少一个程序定义类型的名称，且实例化满足标准库对原始模板的要求时，允许进行显示实例化。

本节未完成
原因：小示例

其他限制

不可将命名空间 std 声明为 inline 命名空间。

可取址函数

若 C++ 程序显式或隐式形成指向标准库函数或标准库函数模板实例化的指针、引用（对于自由函数和静态成员函数）或成员指针（对于非静态成员函数），则程序行为未指明（可能非良构），除非该函数被指定为可取址函数。

标准库中仅有的可取址函数是作为函数（或函数模板实例化），接收一个流对象的引用作为其唯一实参的 I/O 操纵符，如 std::endl、std::boolalpha。

下列代码在 C++17 中有恰当定义，但从 C++20 起导致未指明行为并且可能无法编译： 

#include <cmath>
#include <memory>
int main()
{
    auto fptr0 = &std::betaf; // 通过一元 operator&
    auto fptr1 = std::addressof(std::betal) // 通过 std::addressof
    auto fptr2 = std::riemann_zetaf; // 通过函数到指针隐式转换
    auto &fref = std::riemann_zetal; // 形成引用
    auto mfptr = &std::allocator<int>::allocate; // 形成成员函数指针
}
 (C++20 èµ·)