tickit_term_new - Man Page

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)

Referenced By

tickit_term(7), tickit_term_await_started_msec(3), tickit_term_bind_event(3), tickit_term_chpen(3), tickit_term_clear(3), tickit_term_emit_key(3), tickit_term_erasech(3), tickit_term_flush(3), tickit_term_get_size(3), tickit_term_get_termtype(3), tickit_term_goto(3), tickit_term_input_check_timeout_msec(3), tickit_term_input_push_bytes(3), tickit_term_input_readable(3), tickit_term_input_wait_msec(3), tickit_term_observe_sigwinch(3), tickit_term_open_stdio(3), tickit_term_pause(3), tickit_term_print(3), tickit_term_ref(3), tickit_term_scrollrect(3), tickit_term_setctl_int(3), tickit_term_set_input_fd(3), tickit_term_set_output_buffer(3), tickit_term_set_output_fd(3), tickit_term_set_output_func(3), tickit_term_set_utf8(3).

The man page tickit_term_new_for_termtype(3) is an alias of tickit_term_new(3).