std:: to_address

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->());
}

注記

std::to_address は、 p がオブジェクトが構築されたストレージを参照していない場合でも使用できます。その場合、 std:: addressof ( * p ) は使用できません。なぜなら、 std:: addressof のパラメータにバインドする有効なオブジェクトが存在しないためです。

std::to_address のファンシーポインタオーバーロードは、 std:: pointer_traits < Ptr > 特殊化を検査します。その特殊化のインスタンス化自体が不適格（通常は element_type が定義できないため）である場合、それは即時コンテキスト外でのハードエラーを引き起こし、プログラムを不適格にします。

std::to_address は、 std::contiguous_iterator を満たすイテレータに対しても使用できます。

例

#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);
}

関連項目