echochar or wechochar Subroutines

Purpose

Echos single-byte character and rendition to a window and refreshes the window.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int echochar(const chtype ch);

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

Description

The echochar subroutine is equivalent to a call to the addch soubroutine followed by a call to the refresh subroutine.

The wechochar subroutine is equivalent to a call to the waddch subroutine followed by a call to the wrefresh subroutine.

Return Values

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

Example

To output the character I to the stdscr at the present cursor location and to update the physical screen, do the following:

echochar('I');

Implementation Specifics

This routine is part of Base Operating System (BOS) Runtime.

Related Information

The addch, doupdate, echo_wchar, waddch, wmvaddch, and mvaddch subroutines.

Curses Overview for Programming and List of Curses Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Manipulating Characters with Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.