25.2.243. PMIx_Procid_invalid

PMIx_Procid_invalid — Test whether a pmix_proc_t(5) is invalid

25.2.243.1. SYNOPSIS

#include <pmix.h>

bool PMIx_Procid_invalid(const pmix_proc_t *p);

25.2.243.1.1. Python Syntax

No Python equivalent

25.2.243.2. INPUT PARAMETERS

25.2.243.3. DESCRIPTION

Test whether a process identifier is invalid. A pmix_proc_t is considered invalid if either its namespace is invalid (NULL or empty, as determined by PMIx_Nspace_invalid(3)) or its rank is equal to PMIX_RANK_INVALID. A process identifier is valid only when both its namespace and its rank are valid.

25.2.243.4. RETURN VALUE

Returns true if the process identifier is invalid (invalid namespace or PMIX_RANK_INVALID rank), and false otherwise.

25.2.243.5. NOTES

PMIx_Procid_invalid is an OpenPMIx convenience routine and is the backing implementation of the PMIX_PROCID_INVALID macro. The argument must point to a valid structure; the routine dereferences p and performs no NULL checking on the pointer itself.