std::shared_ptr

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

Регулярные выражения (C++11)

Атомарные примитивы (C++11)

Потоки (C++11)

 

Утилиты библиотеки

Поддежка типов (базовые типы, RTTI, type traits)

Динамическое управление памятью

Обработка ошибок

Управление жизненным циклом программы

Функции с переменным числом аргументов

Дата и время

Функциональные объекты

initializer_list (C++11)

bitset

hash (C++11)

Реляционные операторы

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

Пары и кортежи

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Обмен, передача и перемещение

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

Динамическое управление памятью

Низкий уровень управления памятью
Распределители Original: Allocators The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
allocator
allocator_traits (C++11)
allocator_arg_t (C++11)
allocator_arg (C++11)
uses_allocator (C++11)
scoped_allocator_adaptor (C++11)
Неинициализированные хранения Original: Uninitialized storage The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
uninitialized_copy
uninitialized_copy_n (C++11)
uninitialized_fill
uninitialized_fill_n
raw_storage_iterator
get_temporary_buffer
return_temporary_buffer
Умные указатели Original: Smart pointers The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
unique_ptr (C++11)
shared_ptr (C++11)
weak_ptr (C++11)
auto_ptr (устарело)
owner_less (C++11)
enable_shared_from_this (C++11)
bad_weak_ptr (C++11)
default_delete (C++11)
Поддержка сборки мусора Original: Garbage collection support The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
declare_reachable (C++11)
undeclare_reachable (C++11)
declare_no_pointers (C++11)
undeclare_no_pointers (C++11)
pointer_safety (C++11)
get_pointer_safety (C++11)
Разное Original: Miscellaneous The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
pointer_traits (C++11)
addressof (C++11)
align (C++11)
C Library Original: C Library The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
malloc calloc	realloc free

 

std::shared_ptr

Член функций Original: Member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

shared_ptr::shared_ptr

shared_ptr::~shared_ptr

shared_ptr::operator=

Модификаторы Original: Modifiers The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

shared_ptr::reset

shared_ptr::swap

Наблюдателей Original: Observers The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

shared_ptr::get

shared_ptr::operator* shared_ptr::operator->

shared_ptr::use_count

shared_ptr::unique

shared_ptr::operator bool

shared_ptr::owner_before

Не являющиеся членами функций Original: Non-member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

std::swap

make_shared

allocate_shared

static_pointer_cast dynamic_pointer_cast const_pointer_cast

get_deleter

operator== operator|= operator< operator<= operator> operator>=

operator<<

atomic_is_lock_free atomic_load atomic_load_explicit atomic_store atomic_store_explicit atomic_exchange atomic_exchange_explicit

std::hash

 

Заголовочный файл <memory>
template< class T > class shared_ptr;		(начиная с C++11)

std::shared_ptr является смарт-указатель, который сохраняет долевой собственности на объект через указатель. Несколько объектов shared_ptr может владеть и тот же объект, объект разрушается, когда последний оставшийся shared_ptr указывая на его повреждения или сбросить. Объект будет уничтожен использованием delete-expression или пользовательские Deleter, который поставляется в shared_ptr во время строительства.

Original:

std::shared_ptr is a smart pointer that retains shared ownership of an object through a pointer. Several shared_ptr objects may own the same object; the object is destroyed when the last remaining shared_ptr pointing to it is destroyed or reset. The object is destroyed using delete-expression or a custom deleter that is supplied to shared_ptr during construction.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

shared_ptr также могут владеть не объекты, и в этом случае он называется пустым.

Original:

A shared_ptr may also own no objects, in which case it is called empty.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

shared_ptr отвечает требованиям CopyConstructible и CopyAssignable.

Original:

shared_ptr meets the requirements of CopyConstructible and CopyAssignable.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Член типов

Член типа Original: Member type The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.	Definition
element_type	T

Член функций

(constructor)	constructs new shared_ptr (public функция-член)
(destructor)	разрушает принадлежащей объекту, если не больше, shared_ptrs ссылку на него Original: destructs the owned object if no more shared_ptrs link to it The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
operator=	назначает shared_ptr Original: assigns the shared_ptr The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
Модификаторы Original: Modifiers The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
reset	заменяет управляемого объекта Original: replaces the managed object The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
swap	свопы управляемых объектов Original: swaps the managed objects The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
Наблюдателей Original: Observers The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
get	возвращает указатель на управляемый объект Original: returns a pointer to the managed object The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
operator* operator->	разыменовывает указатель на управляемый объект Original: dereferences pointer to the managed object The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
use_count	возвращает количество объектов shared_ptr ссылаясь на те же управляемый объект Original: returns the number of shared_ptr objects referring to the same managed object The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
unique	проверяет, является ли управляемый объект удалось только в текущем экземпляре shared_ptr Original: checks whether the managed object is managed only by the current shared_ptr instance The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
operator bool	проверяет, не связан управляемого объекта Original: checks if there is associated managed object The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
owner_before	предоставляет владельцу на основе упорядочения общих указателей Original: provides owner-based ordering of shared pointers The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)

Не являющиеся членами функций

make_shared	создает общий указатель, который управляет новый объект Original: creates a shared pointer that manages a new object The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)
allocate_shared	создает общий указатель, который управляет новый объект выделяется использованием распределителя Original: creates a shared pointer that manages a new object allocated using an allocator The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)
static_pointer_cast dynamic_pointer_cast const_pointer_cast	применяется static_cast, dynamic_cast или const_cast к типу управляемого объекта Original: applies static_cast, dynamic_cast or const_cast to the type of the managed object The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)
get_deleter	возвращает Deleter указанного типа, если они принадлежат Original: returns the deleter of specified type, if owned The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)
operator== operator!= operator< operator<= operator> operator>=	сравнивается с другим shared_ptr или с nullptr Original: compares with another shared_ptr or with nullptr The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)
operator<<	выводит значение управляемый указатель на поток вывода Original: outputs the value of the managed pointer to an output stream The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)
std::swap(std::shared_ptr) (C++11)	Специализируется std::swap алгоритм Original: specializes the std::swap algorithm The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)

std::atomic_is_lock_free(std::shared_ptr) std::atomic_load(std::shared_ptr) std::atomic_load_explicit(std::shared_ptr) std::atomic_store(std::shared_ptr) std::atomic_store_explicit(std::shared_ptr) std::atomic_exchange(std::shared_ptr) std::atomic_exchange_explicit(std::shared_ptr) std::atomic_compare_exchange_weak(std::shared_ptr) std::atomic_compare_exchange_strong(std::shared_ptr) std::atomic_compare_exchange_weak_explicit(std::shared_ptr) std::atomic_compare_exchange_strong_explicit(std::shared_ptr)

Специализируется атомарных операций Original: specializes atomic operations The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)

Вспомогательные классы

std::hash<std::shared_ptr> (C++11)	хэш поддержку std::shared_ptr Original: hash support for std::shared_ptr The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (специализация шаблона класса)

Реализация заметки

В типичной реализации, std::shared_ptr имеет место только два указателя:

Original:

In a typical implementation, std::shared_ptr holds only two pointers:

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

• указатель на соответствующий объект

  Original:

  a pointer to the referenced object

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Указатель' блок управления

  Original:

  a pointer to control block

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Если блок управления является динамически выделяется объект, который имеет место

Original:

Where the control block is a dynamically-allocated object that holds:

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

• указатель на управляемый объект или управляемый объект

  Original:

  a pointer to the managed object or the managed object itself

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Deleter

  Original:

  the deleter

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• распределителя

  Original:

  the allocator

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Число shared_ptrs, к которой принадлежит управляемого объекта

  Original:

  the number of shared_ptrs that own the managed object

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Число weak_ptrs, которые относятся к управляемому объекту

  Original:

  the number of weak_ptrs that refer to the managed object

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Когда shared_ptr создается путем вызова std::make_shared или std::allocate_shared, блок управления имеет управляемый объект напрямую, в качестве члена данных. Когда shared_ptr создается путем вызова конструктора, указатель хранится.

Original:

When shared_ptr is created by calling std::make_shared or std::allocate_shared, the control block holds the managed object directly, as a data member. When shared_ptr is created by calling a constructor, a pointer is stored.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Указатель проводимых shared_ptr непосредственно является одной возвращается get(), в то время как указатель / объекта, принадлежащих блок управления является тот, который будет удален, когда число общих владельцев достигает нуля: эти указатели не обязательно равны.

Original:

The pointer held by the shared_ptr directly is the one returned by get(), while the pointer/object held by the control block is the one that will be deleted when the number of shared owners reaches zero: these pointers are not necessarily equal.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Деструктор shared_ptr уменьшает число общих владельцев контрольного пакета, и если это дойдет до нуля, блок управления вызывает деструктор управляемого объекта, но блок управления не освобождает себя, пока std::weak_ptr счетчик достигает нуля, а.

Original:

The destructor of shared_ptr decrements the number of shared owners of the control block, and if that reaches zero, the control block calls the destructor of the managed object, but the control block does not deallocate itself until the std::weak_ptr counter reaches zero as well.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.