.. _man3-PMIx_Device_destruct: PMIx_Device_destruct ==================== .. include_body ``PMIx_Device_destruct`` |mdash| Release the contents of a :ref:`pmix_device_t(5) ` structure. SYNOPSIS -------- .. code-block:: c #include void PMIx_Device_destruct(pmix_device_t *d); Python Syntax ^^^^^^^^^^^^^ No Python equivalent INPUT PARAMETERS ---------------- * ``d``: Pointer to the :ref:`pmix_device_t(5) ` structure whose contents are to be released. DESCRIPTION ----------- Release any heap memory referenced by the fields of a :ref:`pmix_device_t ` structure. Specifically, the ``uuid`` and ``osname`` strings are freed if they are non-``NULL``. The storage for the structure itself is **not** freed |mdash| that remains the responsibility of the caller, since a constructed structure occupies caller-provided storage. ``PMIx_Device_destruct`` is the counterpart to :ref:`PMIx_Device_construct(3) ` and should be used on any structure that was initialized with it. To release an array of structures that was allocated by :ref:`PMIx_Device_create(3) `, use :ref:`PMIx_Device_free(3) ` instead, which both destructs the contents and frees the array storage. RETURN VALUE ------------ ``PMIx_Device_destruct`` returns no value (``void``). .. seealso:: :ref:`PMIx_Device_construct(3) `, :ref:`PMIx_Device_create(3) `, :ref:`PMIx_Device_free(3) `, :ref:`pmix_device_t(5) `