NAME

       tickit_new_stdio - create a new toplevel Tickit instance

SYNOPSIS

       #include <tickit.h>

       Tickit *tickit_new_stdio(void);
       Tickit *tickit_new_stdtty(void);

       Link with -ltickit.

DESCRIPTION

       tickit_new_stdio()  creates  a  new toplevel Tickit instance whose terminal is attached to
       the standard input and output streams.

       tickit_new_stdtty() creates a new toplevel Tickit instance whose terminal is  attached  to
       the  first  terminal  found among the standard input, output and error streams. This gives
       better results if the containing program is likely to be invoked with shell redirection on
       either input or output (e.g. similar to less).

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

RETURN VALUE

       If  successful,  tickit_new_stdio()  and  tickit_new_stdtty()  return a pointer to the new
       instance.

SEE ALSO

       tickit(7)

                                                                              TICKIT_NEW_STDIO(3)