18.2.201. PMIx_Device_destruct

PMIx_Device_destruct — Release the contents of a pmix_device_t(5) structure.

18.2.201.1. SYNOPSIS

#include <pmix.h>

void PMIx_Device_destruct(pmix_device_t *d);

18.2.201.1.1. Python Syntax

No Python equivalent

18.2.201.2. INPUT PARAMETERS

d: Pointer to the pmix_device_t(5) structure whose contents are to be released.

18.2.201.3. DESCRIPTION

Release any heap memory referenced by the fields of a 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 — that remains the responsibility of the caller, since a constructed structure occupies caller-provided storage.

PMIx_Device_destruct is the counterpart to 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 PMIx_Device_create(3), use PMIx_Device_free(3) instead, which both destructs the contents and frees the array storage.

18.2.201.4. RETURN VALUE

PMIx_Device_destruct returns no value (void).