Sortix volatile manual
This manual documents Sortix volatile, a development build that has not been officially released. You can instead view this document in the latest official manual.
CURSES_ECHOCHAR(3) | Library Functions Manual | CURSES_ECHOCHAR(3) |
NAME
curses_echochar
,
echochar
, wechochar
,
pechochar
— curses add
characters and then refresh routines
LIBRARY
Curses Library (libcurses, -lcurses)
SYNOPSIS
#include
<curses.h>
int
echochar
(const
chtype ch);
int
wechochar
(WINDOW
*win, const chtype
ch);
int
pechochar
(WINDOW
*pad, const chtype
ch);
DESCRIPTION
These functions add characters to stdscr
or to the specified window or pad and then cause an immediate
refresh
()
of that window or pad.
The
echochar
()
function adds the character given in ch to
stdscr
at the current cursor position and advances
the current cursor position by one. Any character attributes set in
ch will be merged with the background attributes
currently set on stdscr
.
stdscr
is then refreshed. Calling
echochar
() is equivalent to calling
addch
()
followed by refresh
().
The
wechochar
()
function is the same as the echochar
() function,
excepting that the character is added to the window specified by
win and win is refreshed.
The
pechochar
()
function is the similar to the echochar
() function,
excepting that the character is added to the pad specified by
pad and pad is refreshed at its
previous location on the screen. Calling pechochar
()
is equivalent to calling addch
() followed by
prefresh
().
RETURN VALUES
These functions will return one of the following values:
OK
- The function completed successfully.
ERR
- An error occurred in the function.
SEE ALSO
curses_addch(3), curses_attributes(3), curses_pad(3), curses_refresh(3)
STANDARDS
The echochar
(),
wechochar
(), and pechochar
()
functions comply with the X/Open Curses specification, part of the Single
Unix Specification.
HISTORY
The Curses package appeared in 4.0BSD.
March 27, 2004 | Sortix 1.1.0-dev |