.\" @(#)PEXChangeNameSet.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXChangeNameSet 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXChangeNameSet \- Change Name Set
.SH SYNTAX
.HP
void PEXChangeNameSet\^(\^Display *\fIdisplay\fP\^, PEXNameSet \fInameset\fP\^,
int \fIaction\fP\^, unsigned long \fIcount\fP\^, PEXName *\fInames\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fInameset\fP
The resource identifier of the name set.
.TP
\fIaction\fP
Type of change to be made (
.B PEXNSAdd,
.B PEXNSRemove,
.B PEXNSReplace
).
.TP
\fIcount\fP
The number of names.
.TP
\fInames\fP
An array of names.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXChangeNameSet
.IX "Name Set" PEXChangeNameSet
.LP
This function modifies the specified name set resource.  The list of
.I names
is added to the name set if the specified
.I action
is
.B PEXNSAdd,
removed from the name set if the specified
.I action
is
.B PEXNSRemove,
or used to replace the
.I names
currently in the name set if the specified
.I action
is
.B PEXNSReplace.
If requested to remove a name that does not exist, it is silently ignored.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID		PEXNameSet;
typedef  unsigned long	PEXName;
.fi
.SH ERRORS
.TP
.SB BadPEXNameSet
The specified name set resource identifier is invalid.
.TP
.SB BadValue
The specified value for
.I action
parameter is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateNameSet (3)
.BR PEXGetNameSet (3)
.fi