NAME

       tickit_term_set_output_func - manage terminal output via a callback function

SYNOPSIS

       #include <tickit.h>

       typedef void TickitTermOutputFunc(TickitTerm *tt, const char *bytes,
           size_t len, void *user);

       void tickit_term_set_output_func(TickitTerm *tt,
           TickitTermOutputFunc *fn, void *user);

       Link with -ltickit.

DESCRIPTION

       tickit_term_set_output_func() associates an output function with the terminal instance. If
       set, this function will be used to send bytes to the user's terminal  even  if  an  output
       file  descriptor is also set. When the function is invoked, it will be passed the terminal
       instance, a byte buffer and size, and the user data pointer it was installed with.

       When an output function is replaced by another or the terminal is destroyed,  an  existing
       function  is invoked one final time to inform it. In this case, the len argument will be 0
       and bytes will be NULL.

       After both an input and output method  have  been  defined,  it  is  recommended  to  call
       tickit_term_await_started(3) to wait for the terminal to be set up.

RETURN VALUE

       tickit_term_set_output_func() returns no value.

SEE ALSO

       tickit_term_new(3),       tickit_term_set_output_fd(3),      tickit_term_await_started(3),
       tickit_term_print(3), tickit_term(7), tickit(7)

                                                                   TICKIT_TERM_SET_OUTPUT_FUNC(3)