PPATH_OBJECT(3) | Library Functions Manual | PPATH_OBJECT(3) |
ppath_object
,
ppath_copydel_object
,
ppath_copyset_object
,
ppath_set_object
,
ppath_get_object
,
ppath_delete_object
,
ppath_copydel_data
,
ppath_copyset_data
,
ppath_set_data
,
ppath_get_data
,
ppath_dup_data
,
ppath_delete_data
,
ppath_copydel_string
,
ppath_copyset_string
,
ppath_set_string
,
ppath_get_string
,
ppath_dup_string
,
ppath_delete_string
—
#include <ppath/ppath.h>
int
ppath_copydel_object
(prop_object_t,
prop_object_t *,
const ppath_t *);
int
ppath_copyset_object
(prop_object_t,
prop_object_t *,
const ppath_t *,
prop_object_t);
int
ppath_set_object
(prop_object_t,
const ppath_t *,
prop_object_t);
int
ppath_get_object
(prop_object_t,
const ppath_t *,
prop_object_t *);
int
ppath_delete_object
(prop_object_t,
const ppath_t *);
int
ppath_copydel_data
(prop_object_t,
prop_object_t *,
const ppath_t *);
int
ppath_copyset_data
(prop_object_t,
prop_object_t *,
const ppath_t *,
const void *,
size_t);
int
ppath_set_data
(prop_object_t,
const ppath_t *,
const void *,
size_t);
int
ppath_get_data
(prop_object_t,
const ppath_t *,
const void **,
size_t *);
int
ppath_dup_data
(prop_object_t,
const ppath_t *,
void **,
size_t *);
int
ppath_delete_data
(prop_object_t,
const ppath_t *);
int
ppath_copydel_string
(prop_object_t,
prop_object_t *,
const ppath_t *);
int
ppath_copyset_string
(prop_object_t,
prop_object_t *,
const ppath_t *,
const char *);
int
ppath_set_string
(prop_object_t,
const ppath_t *,
const char *);
int
ppath_get_string
(prop_object_t,
const ppath_t *,
const char **);
int
ppath_dup_string
(prop_object_t,
const ppath_t *,
char **);
int
ppath_delete_string
(prop_object_t,
const ppath_t *);
ppath_object
routines read, write, or delete objects
in a property list by path.
ppath_object
provides these functions for manipulating
objects in a property list by the objects' paths:
ppath_copydel_object
(prop_object_t
o, prop_object_t *op, const
ppath_t *p)If *op is NULL
,
ppath_copydel_object
() creates a shallow copy of
o at *op. If
*op is not NULL
,
ppath_copydel_object
() expects for
*op to be an existing shallow copy of
o.
For the purposes of
ppath_copydel_object
(),
*op is a shallow copy of property list
o if equal properties at equal paths are shared
between the two. Before ppath_copydel_object
()
modifies a property shared by *op and
o, it creates a private copy of the property for
*op.
ppath_copyset_object
(prop_object_t
o, prop_object_t *op, const
ppath_t *p, prop_object_t v)If *op is NULL
,
ppath_copyset_object
() creates a shallow copy of
o at *op. If
*op is not NULL
,
ppath_copyset_object
() expects for
*op to be an existing shallow copy of
o.
For the purposes of
ppath_copyset_object
(),
*op is a shallow copy of property list
o if equal properties at equal paths are shared
between the two. Before ppath_copydel_object
()
modifies a property shared by *op and
o, it creates a private copy of the property for
*op.
ppath_set_object
(prop_object_t
o, const ppath_t *p,
prop_object_t v)ppath_get_object
(prop_object_t
o, const ppath_t *p,
prop_object_t *vp)ppath_get_object
() does
not increase the reference count of the retrieved
object.ppath_delete_object
(prop_object_t
o, const ppath_t *p)ppath_delete_object
() decreases by one the deleted
object's reference count.ppath_object
routines return 0 on success, and non-zero
on error.
EFTYPE
]ppath_object
call requested aENOENT
]ppath_copyset_object
(),
ppath_delete_object
(),
ppath_get_object
(), and
ppath_set_object
() return
ENOENT
if the path p does not exist in
o.ENOMEM
]ppath_set_object
() and
ppath_copyset_object
() will return
ENOMEM
if there was insufficient memory to complete the operation.ppath_object
property container path library first
appeared in NetBSD 6.0.
August 24, 2011 | NetBSD 9.0 |