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 9.0