CURSES_ECHOCHAR(3) Library Functions Manual CURSES_ECHOCHAR(3)

curses_echochar, echochar, wechochar, pechochar — curses add characters and then refresh routines

Curses Library (libcurses, -lcurses)

#include <curses.h>

int
echochar(const chtype ch);

int
wechochar(WINDOW *win, const chtype ch);

int
pechochar(WINDOW *pad, const chtype ch);

These functions add characters to stdscr or to the specified window or pad and then cause an immediate () of that window or pad.

The () 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 () followed by refresh().

The () 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 () 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 ().

These functions will return one of the following values:

OK
The function completed successfully.
ERR
An error occurred in the function.

curses_addch(3), curses_attributes(3), curses_pad(3), curses_refresh(3)

The echochar(), wechochar(), and pechochar() functions comply with the X/Open Curses specification, part of the Single Unix Specification.

The Curses package appeared in 4.0BSD.

March 27, 2004 NetBSD 11.0