CURSES_ECHOCHAR(3)

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 | NetBSD 5.99