std:: inout_ptr_t

inout_ptr_t используется для адаптации типов, таких как умные указатели, для внешних функций, которые сбрасывают владение через параметр Pointer* (обычно T** для некоторого типа объекта T ) или void ** параметр.

inout_ptr_t захватывает дополнительные аргументы при конструировании, предоставляет хранилище для результата, к которому обращается упомянутая внешняя функция, освобождает владение, удерживаемое адаптированным объектом Smart , и, наконец, переустанавливает адаптированный объект Smart с результатом и захваченными аргументами при своем разрушении.

inout_ptr_t ведет себя так, как если бы он содержал следующие нестатические члены данных:

• умная ссылка Smart& , которая связывается с адаптированным объектом при создании,
• для каждого T в Args... - член типа T , который представляет собой аргумент, захваченный при создании и используемый для сброса при уничтожении, и
• член-подобъект, подходящий для хранения Pointer внутри себя и предоставления объекта типа void * , где Pointer или void * объект обычно предоставляется внешней функции для сброса владения.

Если Smart не является типом указателя, release ( ) вызывается не более одного раза для адаптированного объекта. Реализации могут вызывать release ( ) в конструкторе, или перед сбросом в деструкторе, если значение Pointer не является нулевым.

Пользователи могут управлять тем, захватывается ли каждый аргумент для сброса по копии или по ссылке, указывая тип объекта или ссылочный тип в Args... соответственно.

Параметры шаблона

Специализации

В отличие от большинства шаблонов классов в стандартной библиотеке, программо-определенные специализации шаблона inout_ptr_t , зависящие хотя бы от одного программо-определенного типа , не обязаны удовлетворять требованиям первичного шаблона.

Данная лицензия позволяет программе-определенной специализации предоставлять доступ к необработанному указателю, хранящемуся внутри нестандартного умного указателя, внешним функциям.

Функции-члены

Функции, не являющиеся членами класса

Примечания

inout_ptr_t ожидает, что внешние функции освобождают владение, представленное значением указателя Pointer , и затем переинициализируют его. Поскольку такая операция требует уникального владения, использование с std::shared_ptr запрещено.

Типичное использование inout_ptr_t заключается в создании временных объектов через std::inout_ptr , который немедленно сбрасывает адаптированный умный указатель. Например, при наличии функции-сеттера и умного указателя соответствующего типа, объявленных как int foreign_resetter ( T ** ) ; и std:: unique_ptr < T, D > up ; соответственно,

if (int ec = foreign_resetter(std::inout_ptr(up)))
    return ec;

примерно эквивалентно

T *raw_p = up.get();
up.release();
int ec = foreign_resetter(&raw_p);
up.reset(raw_p);
if (ec != 0)
    return ec;

Не рекомендуется создавать объект inout_ptr_t с продолжительностью хранения отличной от автоматической, поскольку такой код может привести к появлению висячих ссылок и неопределённому поведению при уничтожении.

Захваченные аргументы обычно упаковываются в std:: tuple < Args... > . Реализации могут использовать различные механизмы для предоставления Pointer или void * объекта, который им необходимо хранить.

Пример

Смотрите также