.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PMIX_REGEX2_CREATE" "3" "Sep 27, 2026" "" "OpenPMIx"
.sp
\fBPMIx_Regex2_create\fP — Allocate and initialize an array of
pmix_regex2_t(5) \%<#\:man5-pmix-regex2-t> structures.
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
#include <pmix.h>

pmix_regex2_t* PMIx_Regex2_create(size_t n);
.EE
.UNINDENT
.UNINDENT
.SS Python Syntax
.sp
No Python equivalent
.SH INPUT PARAMETERS
.INDENT 0.0
.IP \(bu 2
\fBn\fP: Number of \fBpmix_regex2_t\fP structures to allocate.
.UNINDENT
.SH DESCRIPTION
.sp
Allocate a contiguous array of \fBn\fP \fBpmix_regex2_t\fP structures on the heap
and construct each element (see PMIx_Regex2_construct(3) \%<#\:man3-pmix-regex2-construct>) so that every \fBtype\fP and \fBbytes\fP pointer is
\fBNULL\fP and every \fBlen\fP is zero. A pointer to the first element of the array
is returned.
.sp
If \fBn\fP is zero, no allocation is performed and \fBNULL\fP is returned.
.SH RETURN VALUE
.sp
Returns a pointer to the newly allocated array of \fBpmix_regex2_t\fP structures,
or \fBNULL\fP if \fBn\fP is zero or the allocation failed.
.SH NOTES
.sp
An array obtained from \fBPMIx_Regex2_create\fP must be released with
PMIx_Regex2_free(3) \%<#\:man3-pmix-regex2-free>, which both destructs the
contents of each element and frees the array storage itself. Do not release
such an array element\-by\-element with PMIx_Regex2_destruct(3) \%<#\:man3-pmix-regex2-destruct>, as that would leave the array storage leaked.
.SH EXAMPLES
.sp
Create and later free an array:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pmix_regex2_t *rex;

rex = PMIx_Regex2_create(2);

/* ... use the array ... */

PMIx_Regex2_free(rex, 2);
.EE
.UNINDENT
.UNINDENT
.sp
\fBSee also:\fP
.INDENT 0.0
.INDENT 3.5
PMIx_Regex2_free(3) \%<#\:man3-pmix-regex2-free>,
PMIx_Regex2_construct(3) \%<#\:man3-pmix-regex2-construct>,
PMIx_Regex2_destruct(3) \%<#\:man3-pmix-regex2-destruct>,
pmix_regex2_t(5) \%<#\:man5-pmix-regex2-t>
.UNINDENT
.UNINDENT
.SH Copyright
2014-2026, OpenPMIx Community
.\" End of generated man page.