focal (3) tickit_string_new.3.gz

NAME

       tickit_string_new - create a counted string

SYNOPSIS

       #include <tickit.h>

       TickitString *tickit_string_new(const char *str, size_t len);

       Link with -ltickit.

DESCRIPTION

       tickit_string_new()  creates a new TickitString instance. It will be initialised with the contents of the
       given string buffer.

       The reference count of a newly-constructed string instance will  be  one.  This  can  be  incremented  or
       decremented  using tickit_string_ref(3) and tickit_string_unref(3). When its reference count reaches zero
       it is destroyed.

RETURN VALUE

       If successful, tickit_string_new() returns a pointer to the new instance.

SEE ALSO

       tickit_string_get(3), tickit_string(7), tickit(7)

                                                                                            TICKIT_STRING_NEW(3)