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)