NAME

       tickit_term_erasech - erase characters from the terminal

SYNOPSIS

       #include <tickit.h>

       void tickit_term_erasech(TickitTerm *tt, int count, TickitMaybeBool moveend);

       Link with -ltickit.

DESCRIPTION

       tickit_term_erasech()  erases  count  character  cells  forward  from  the  current cursor
       location, using the current pen background colour.

       Some terminals cannot erase  using  the  background  colour,  so  this  operation  may  be
       implemented  by printing spaces on such terminals. This will move the cursor to the end of
       the erased region. Other terminals that do erase with  background  colour  can  be  erased
       without  moving  the  cursor.  The  moveend parameter controls the behaviour of the cursor
       location when this function returns. If set to TICKIT_YES, the cursor will be moved to the
       end  of  the erased region if required. If set to TICKIT_NO, the cursor will be moved back
       to its original location if required. If set to  TICKIT_MAYBE,  this  function  will  take
       whichever behaviour is more optimal on the given terminal.

RETURN VALUE

       tickit_term_erasech() returns no value.

SEE ALSO

       tickit_term_build(3),  tickit_term_goto(3),  tickit_term_print(3),  tickit_term_setpen(3),
       tickit_term_chpen(3), tickit_term(7), tickit(7)

                                                                           TICKIT_TERM_ERASECH(3)