SS8_LEN(3)                       Ssstr Manual                       SS8_LEN(3)

NAME
       ss8_len, ss8_is_empty - query length of ssstr byte string

SYNOPSIS
       #include <ss8str.h>

       size_t ss8_len(ss8str const *str);
       bool   ss8_is_empty(ss8str const *str);

DESCRIPTION
       ss8_len() queries the length of the ss8str pointed to by str.

       ss8_is_empty()  tests  whether  the  ss8str pointed to by str is empty,
       that is, has a length of zero.

       For either function, behavior is undefined unless str points to a valid
       ss8str object.

       The length of an ss8str is stored explicitly and is not affected by the
       byte string it contains.  Specifically, if the byte string contains em‐
       bedded null bytes, its length will differ from what strlen() would  re‐
       turn when called on the equivalent string.

RETURN VALUE
       ss8_len()  returns  the length, in bytes, of the string at str, not in‐
       cluding the null terminator that would  be  part  of  the  string  when
       viewed  as  a  null-terminated byte string.  Any embedded null bytes in
       the string do not affect the length.

       ss8_is_empty() returns true when str has a length of zero; otherwise it
       returns false.

SEE ALSO
       ss8_capacity(3), ss8_set_len(3), ssstr(7)

SSSTR                             2023-12-30                        SS8_LEN(3)