GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • cpprefjp - C++日本語リファレンス
  • GitHub Project

This view

  • Original page
  • New address

GeezerVison is showing cpprefjp.github.io — std::ranges::construct_at - cpprefjp C++日本語リファレンス

  1. リファレンス
  2. memory
  3. construct_at

最終更新日時: 2026年08月18日 11時11分59秒 (JST)
Akira Takahashi が更新

履歴 編集

function template
<memory>

std::ranges::construct_at(C++20)

namespace std::ranges {
  template <class T, class... Args>
  constexpr T* construct_at(T* location, Args&&... args); // (1) C++20
}

概要

コンストラクタを呼び出す。

locationの位置に配置newで型Tのコンストラクタを呼び出す。

テンプレートパラメータ制約

  • 式::new (declval<void*>()) T(declval<Args>()...)が評価されないオペランドとして扱われる場合に、適格であること

効果

以下の関数があるとして、

template<class T>
constexpr void* voidify(T& ptr) noexcept {
  return addressof(ptr);
}

以下と等価:

auto ptr = ::new (voidify(*location)) T(std::forward<Args>(args)...);
if constexpr (is_array_v<T>)
  return launder(location);
else
  return ptr;

例

#include <iostream>
#include <memory>

int main()
{
  // 配置newでオブジェクトを構築
  char storage[4];
  int* n = std::ranges::construct_at(reinterpret_cast<int*>(storage));

  *n = 314;
  std::cout << *n << std::endl;

  // デストラクタを呼び出して破棄
  std::ranges::destroy_at(n);
}

出力

314

バージョン

言語

  • C++20

処理系

  • Clang: 16.0 ✅
  • GCC: 10.2.0 ✅
  • Visual C++: 2019 Update 10 ✅

関連項目

  • construct_at

参照

  • P0896R4 The One Ranges Proposal
  • LWG Issue 3436. std::construct_at should support arrays
  • LWG Issue 3870. Remove voidify
    • C++23で、説明専用関数voidifyの本体がconst_cast/static_castを用いる形からaddressofを返す形に変更され、const記憶域へのオブジェクト構築が禁じられた
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.