focal (3) tickit_term_new.3.gz

NAME

       tickit_term_new - create a new terminal instance

SYNOPSIS

       #include <tickit.h>

       TickitTerm *tickit_term_new(void);
       TickitTerm *tickit_term_new_for_termtype(const char *termtype);

       Link with -ltickit.

DESCRIPTION

       tickit_term_new()  creates  a new TickitTerm instance for the terminal type given by the TERM environment
       variable.

       tickit_term_new_for_termtype() creates a new TickitTerm instance for the given terminal type.

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

RETURN VALUE

       If successful, tickit_term_new() and tickit_term_new_for_termtype() return a pointer to the new instance.
       On failure, NULL is returned with errno set to indicate the failure.

SEE ALSO

       tickit_term_open_stdio(3),          tickit_term_set_output_fd(3),         tickit_term_set_output_func(3),
       tickit_term_set_input_fd(3), tickit_term_print(3), tickit_term_bind_event(3), tickit_term(7), tickit(7)

                                                                                              TICKIT_TERM_NEW(3)