命名空间
变体
操作

std::to_address

来自 cppreference.com
< cpp‎ | memory
 
 
实用程序库
语言支持
类型支持 (基本类型、RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三元比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (在 C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
动态内存管理
未初始化内存算法
受约束的未初始化内存算法
分配器
垃圾收集支持
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)



 
定义在头文件 <memory>
template< class Ptr >
constexpr auto to_address( const Ptr& p ) noexcept;
(1) (自 C++20 起)
template< class T >
constexpr T* to_address( T* p ) noexcept;
(2) (自 C++20 起)

在不形成对 p 指向的对象的引用的情况下,获取 p 表示的地址。

1) 奇特指针 重载:如果表达式 std::pointer_traits<Ptr>::to_address(p) 格式良好,则返回该表达式的结果。否则,返回 std::to_address(p.operator->()).
2) 原始指针重载:如果 T 是一个函数类型,程序格式不正确。否则,返回 p 不作修改。

内容

[编辑] 参数

p - 奇特指针或原始指针

[编辑] 返回值

表示与 p 相同地址的原始指针。

[编辑] 可能的实现

template<class T>
constexpr T* to_address(T* p) noexcept
{
    static_assert(!std::is_function_v<T>);
    return p;
}
 
template<class T>
constexpr auto to_address(const T& p) noexcept
{
    if constexpr (requires{ std::pointer_traits<T>::to_address(p); })
        return std::pointer_traits<T>::to_address(p);
    else
        return std::to_address(p.operator->());
}

[编辑] 注释

即使 p 不引用已在其中构造对象的存储,也可以使用 std::to_address,在这种情况下,std::addressof(*p) 不能使用,因为没有有效的对象供 std::addressof 的参数绑定。

std::to_address 的奇特指针重载检查 std::pointer_traits<Ptr> 特化。如果实例化该特化本身格式不正确(通常是因为无法定义 element_type),则会导致在直接上下文之外发生严重错误,并使程序格式不正确。

std::to_address 还可以在满足 std::contiguous_iterator 的迭代器上使用。

功能测试 Std 功能
__cpp_lib_to_address 201711L (C++20) 将指针转换为原始指针的实用程序 (std::to_address)

[编辑] 示例

#include <memory>
 
template<class A>
auto allocator_new(A& a)
{
    auto p = a.allocate(1);
    try
    {
        std::allocator_traits<A>::construct(a, std::to_address(p));
    }
    catch (...)
    {
        a.deallocate(p, 1);
        throw;
    }
    return p;
}
 
template<class A>
void allocator_delete(A& a, typename std::allocator_traits<A>::pointer p)
{
    std::allocator_traits<A>::destroy(a, std::to_address(p));
    a.deallocate(p, 1);
}
 
int main()
{
    std::allocator<int> a;
    auto p = allocator_new(a);
    allocator_delete(a, p);
}

[编辑] 参见

提供有关指针类型的信息
(类模板) [编辑]
[静态] (C++20)(可选)
从复杂指针中获取原始指针(pointer_to 的反向操作)
(std::pointer_traits<Ptr> 的公共静态成员函数) [编辑]