PROP_STRING(3) | Library Functions Manual | PROP_STRING(3) |
prop_string
,
prop_string_create_copy
,
prop_string_create_format
,
prop_string_create_nocopy
,
prop_string_value
,
prop_string_copy_value
,
prop_string_copy
,
prop_string_size
,
prop_string_equals
,
prop_string_equals_string
,
prop_string_compare
,
prop_string_compare_string
—
#include <prop/proplib.h>
prop_string_t
prop_string_create_copy
(const
char *cstring);
prop_string_t
prop_string_create_format
(const
char *fmt,
...);
prop_string_t
prop_string_create_nocopy
(const
char *cstring);
prop_string_t
prop_string_copy
(prop_string_t
string);
bool
prop_string_copy_value
(prop_string_t
string, char *buf,
size_t buflen);
size_t
prop_string_size
(prop_string_t
string);
const char *
prop_string_value
(prop_string_t
string);
bool
prop_string_equals
(prop_string_t
str1, prop_string_t
str2);
bool
prop_string_equals_string
(prop_string_t
string, const char
*cstring);
int
prop_string_compare
(prop_string_t
str1, prop_string_t
str2);
int
prop_string_compare_string
(prop_string_t
string, const char
*cstring);
prop_string
family of functions operate on a string
value property object type.
prop_string_create_copy
(const char
*cstring)NULL
on
failure.prop_string_create_format
(const
char *fmt, ...)prop_string_create_copy
(), but creates
the string using the specified
printf(3) format.prop_string_create_nocopy
(const
char *cstring)prop_string_create_copy
(), but is
allowed to not create an internal copy of the string data, instead
referencing the string data passed by the caller. Caution must be
exercised because string objects can have an indefinite lifespan. The
caller must therefore ensure that the provided string data reference will
also be valid indefinitely. This is provided only as a memory
optimization; it is not guaranteed that the returned string object will
reference the provided string data, and thus callers should not rely on
this behavior. Returns NULL
on failure.prop_string_copy
(prop_string_t
string)NULL
on failure.prop_string_size
(prop_string_t
string)prop_string_value
(prop_string_t
string)NULL
is
returned.prop_string_copy_value
(prop_string_t
string, void *buf, size_t
buflen)true
if the copy succeeds and
false
if the supplied buffer is not large enough
or if the object is not a string object.prop_string_equals
(prop_string_t
str1, prop_string_t str2)true
if the two string objects are
equivalent.prop_string_equals_string
(prop_string_t
string, const char *cstring)true
if the string's value is equivalent
to cstring.prop_string_compare
(prop_string_t
str1, prop_string_t str2)prop_string_compare_string
(prop_string_t
string, const char *cstring)June 2, 2020 | NetBSD 10.1 |