std:: inout_ptr_t

inout_ptr_t se utiliza para adaptar tipos como punteros inteligentes para funciones externas que restablecen la propiedad mediante un parámetro Pointer* (generalmente T** para algún tipo de objeto T ) o void ** .

inout_ptr_t captura argumentos adicionales en la construcción, proporciona un almacenamiento para el resultado que dicha función externa antes mencionada accede, libera la propiedad mantenida por el objeto Smart adaptado, y finalmente restablece el objeto Smart adaptado con el resultado y los argumentos capturados cuando es destruido.

inout_ptr_t se comporta como si contuviera los siguientes miembros de datos no estáticos:

• una referencia Smart& , que se vincula al objeto adaptado durante la construcción,
• para cada T en Args... , un miembro de tipo T , que es un argumento capturado durante la construcción y utilizado para el restablecimiento durante la destrucción, y
• un subobjeto miembro adecuado para almacenar un Pointer dentro de él y proporcionar un objeto void * , donde el objeto Pointer o void * generalmente se expone a una función externa para el restablecimiento de propiedad.

Si Smart no es un tipo puntero, release ( ) se llama como máximo una vez al objeto adaptado. Las implementaciones pueden llamar release ( ) dentro del constructor, o antes del reinicio dentro del destructor si el valor de Pointer no es nulo.

Los usuarios pueden controlar si cada argumento para el restablecimiento se captura por copia o por referencia, especificando un tipo de objeto o un tipo de referencia en Args... respectivamente.

Parámetros de plantilla

Especializaciones

A diferencia de la mayoría de las plantillas de clase en la biblioteca estándar, las especializaciones definidas por el programa de inout_ptr_t que dependen de al menos un tipo definido por el programa no necesitan cumplir con los requisitos de la plantilla principal.

Esta licencia permite que una especialización definida por el programa exponga el puntero en bruto almacenado dentro de un puntero inteligente no estándar a funciones externas.

Funciones miembro

Funciones no miembro

Notas

inout_ptr_t espera que las funciones externas liberen la propiedad representada por el valor del Pointer apuntado, y luego lo reinicialicen. Dado que esta operación requiere propiedad única, el uso con std::shared_ptr está prohibido.

El uso típico de inout_ptr_t es crear sus objetos temporales mediante std::inout_ptr , que restablece inmediatamente el puntero inteligente adaptado. Por ejemplo, dada una función establecedora y un puntero inteligente del tipo apropiado declarado con int foreign_resetter ( T ** ) ; y std:: unique_ptr < T, D > up ; respectivamente,

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

es aproximadamente equivalente a

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

No se recomienda crear un objeto inout_ptr_t con una duración de almacenamiento diferente a la duración de almacenamiento automática, porque dicho código probablemente producirá referencias colgantes y resultará en comportamiento indefinido durante la destrucción.

Los argumentos capturados típicamente se empaquetan en un std:: tuple < Args... > . Las implementaciones pueden utilizar diferentes mecanismos para proporcionar el objeto Pointer o void * que necesitan contener.

Ejemplo

Véase también