18.2.243. PMIx_Multicluster_nspace_parse

PMIx_Multicluster_nspace_parse — Split a multicluster pmix_nspace_t(5) into its cluster and namespace parts

18.2.243.1. SYNOPSIS

#include <pmix.h>

void PMIx_Multicluster_nspace_parse(pmix_nspace_t target,
                                    pmix_nspace_t cluster,
                                    pmix_nspace_t nspace);

18.2.243.1.1. Python Syntax

No Python equivalent

18.2.243.2. INPUT/OUTPUT PARAMETERS

  • target: The combined multicluster namespace (of the form cluster:nspace) to be parsed.

  • cluster: The pmix_nspace_t(5) (supplied by the caller) into which the cluster portion is written.

  • nspace: The pmix_nspace_t(5) (supplied by the caller) into which the namespace portion is written.

18.2.243.3. DESCRIPTION

Parse a combined multicluster namespace — as produced by PMIx_Multicluster_nspace_construct(3) — back into its two components. The characters of target up to the first ':' separator are copied into cluster; the characters following the separator are copied into nspace. The cluster output is cleared before parsing begins.

18.2.243.4. RETURN VALUE

PMIx_Multicluster_nspace_parse returns no value (void).

18.2.243.5. NOTES

PMIx_Multicluster_nspace_parse is an OpenPMIx convenience routine and is the backing implementation of the PMIX_MULTICLUSTER_NSPACE_PARSE macro. The cluster and nspace output arrays must be supplied by the caller.