20.2.243. PMIx_Rank_valid

PMIx_Rank_valid — Test whether a pmix_rank_t(5) is a valid process rank

20.2.243.1. SYNOPSIS

#include <pmix.h>

bool PMIx_Rank_valid(pmix_rank_t a);

20.2.243.1.1. Python Syntax

No Python equivalent

20.2.243.2. INPUT PARAMETERS

a: The pmix_rank_t(5) value to be tested.

20.2.243.3. DESCRIPTION

Test whether a rank is a valid process rank. The upper end of the pmix_rank_t value space is reserved for special sentinel values such as PMIX_RANK_WILDCARD, PMIX_RANK_UNDEF, and PMIX_RANK_INVALID. This routine returns true only for values that fall below PMIX_RANK_VALID — that is, ranks that denote an actual process position rather than one of the reserved markers.

20.2.243.4. RETURN VALUE

Returns true if a is strictly less than PMIX_RANK_VALID (a valid process rank), and false otherwise.

20.2.243.5. NOTES

PMIx_Rank_valid is an OpenPMIx convenience routine and is the backing implementation of the PMIX_RANK_IS_VALID macro.