pechochar(3curses)


pechochar -- write a character and rendition and immediately refresh the pad

Synopsis

cc [options] file -lcurses
#include <curses.h>

int pechochar(WINDOW *pad, chtype ch);

int pecho_wchar(WINDOW *pad, const cchar_t *wch);

Description

The pechochar(3curses) and pecho_wchar(3curses) functions output one character to a pad and immediately refresh the pad. They are equivalent to a call to waddch(3curses) or wadd_wch(3curses), respectively, followed by a call to prefresh(3curses). The last location of the pad on the screen is reused for the arguments to prefresh(3curses).

Return value

Upon successful completion, these functions return OK. Otherwise, they return ERR.

Errors

No errors are defined.

Usage

The pechochar(3curses) function is only guaranteed to operate reliably on character sets in which each character fits into a single byte, whose attributes can be expressed using only constants with the A_ prefix.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

echochar(3curses), newpad(3curses), curses(4)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004