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 11.0