SYNOPSIS¶

#include <pmix.h>
pmix_value_t* PMIx_Value_create(size_t n);

INPUT PARAMETERS¶

DESCRIPTION¶

Allocate a contiguous array of n pmix_value_t(5) <#man5-pmix-value-t> structures on the heap and construct each element (zeroing it and setting its type to PMIX_UNDEF), exactly as PMIx_Value_construct(3) <#man3-pmix-value-construct> does for a single value.

The returned array is owned by the caller and must be released with PMIx_Value_free(3) <#man3-pmix-value-free>, passing the same count n, which destructs the contents of each element and frees the array storage.

RETURN VALUE¶

Returns a pointer to the newly allocated array of pmix_value_t(5) <#man5-pmix-value-t> structures on success.

Returns NULL if n is zero or if the allocation fails.

NOTES¶

PMIx_Value_create is an OpenPMIx convenience routine. The corresponding macro-style interface for this operation is PMIX_VALUE_CREATE.

EXAMPLES¶

Create and later release an array of values:

pmix_value_t *array;
array = PMIx_Value_create(4);
if (NULL == array) {


    /* handle allocation failure */
}
/* ... use the array ... */
PMIx_Value_free(array, 4);

See also:

Copyright¶

2014-2026, OpenPMIx Community