idset_add(3)¶
SYNOPSIS¶
#include <flux/idset.h>
struct idset *idset_union (const struct idset *a,
const struct idset *b);
struct idset *idset_difference (const struct idset *a,
const struct idset *b);
struct idset *idset_intersect (const struct idset *a,
const struct idset *b);
int idset_add (struct idset *a,
const struct idset *b);
int idset_subtract (struct idset *a,
const struct idset *b);
bool idset_has_intersection (const struct idset *a,
const struct idset *b);
#define idset_clear_all (x) idset_subtract (x, x)
USAGE¶
cc [flags] files -lflux-idset [libraries]
DESCRIPTION¶
Refer to idset_create(3) for a general description of idsets.
idset_union()
creates a new idset that is the union of a and b.
idset_difference()
creates a new idset that is a with the members of
b removed.
idset_intersect()
creates a new idset containing only members of a
and b that are in both sets.
idset_add()
adds the members of b to a.
idset_subtract()
removes the members of b from a.
idset_has_intersection()
tests whether a and b have any members
in common.
idset_clear_all()
removes all members of x
RETURN VALUE¶
idset_union()
, idset_difference()
, and idset_intersect()
return an
idset on success which must be freed with idset_destroy()
. On error,
NULL is returned with errno set.
idset_add()
, idset_subtract()
, and idset_clear_all()
return 0
on success. On error, -1 is returned with errno set.
idset_has_intersection()
returns true or false.
ERRORS¶
- EINVAL
One or more arguments were invalid.
- ENOMEM
Out of memory.
RESOURCES¶
Flux: http://flux-framework.org
RFC 22: Idset String Representation: https://flux-framework.readthedocs.io/projects/flux-rfc/en/latest/spec_22.html