Header Reference: <memory>

Header Reference: <memory>

Smart pointers, allocators, uninitialized-memory helpers, and the ownership vocabulary provided by the memory header.

How to use this reference page

Use reference pages to confirm names, categories, nearby facilities, and the constraints that matter before writing or reviewing code.

  • Scan the top of the page first to identify the primary types, functions, or algorithm families involved.
  • Use the nearby-page links when your question is really about a companion header, related algorithm family, or broader subsystem.
  • Validate tricky behavior with a small compileable example before relying on memory for details like invalidation, ordering, allocation, or lifetime rules.

What header pages are for

Header reference pages are meant to answer a practical question quickly: what this header provides, when to reach for it, and which usage rules are easiest to get wrong.

  • Start here when you already know roughly which header you need but want a fast operational summary.
  • Use the example section below as a minimal pattern, then adapt it to your real container, ownership, text, or concurrency workflow.
  • Jump to broader index pages when you need exhaustive coverage rather than a header-focused summary.

Header Reference: <memory>

Main ownership types

Supporting facilities

What this header is really about

Practical choice rules

Design questions to answer first

Example workflow

#include <memory>
#include <string>

struct Widget {
	explicit Widget(std::string name) : name(std::move(name)) {}
	std::string name;
};

int main() {
	auto widget = std::make_unique<Widget>("core");
	auto shared = std::make_shared<Widget>(widget->name);
	return shared->name == "core" ? 0 : 1;
}

Common pitfalls

Nearby pages

Minimal example

#include <memory>
#include <string>

int main() {
    auto owner = std::make_unique<std::string>("notes");
    auto shared = std::make_shared<std::string>(*owner);

    owner.reset();
    return static_cast<int>(shared->size());
}

What to verify before relying on this header

  • Whether the type models ownership, borrowing, type erasure, value transport, or a compile-time constraint.
  • Which operations are constant time versus potentially allocating, dispatching, or instantiating more template machinery than expected.
  • How the facility composes with nearby headers like ``, ``, ``, or ``.