Technical Reference: Base Operating System and Extensions , Volume 2

echo or noecho Subroutine

Purpose

Enables/disables terminal echo.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int echo(void);

int noecho(void);

Description

The echo subroutine enables Echo mode for the current screen. The noecho subroutine disables Echo mode for the current screen. Initially, curses software echo mode is enabled and hardware echo mode of the tty driver is disabled. The echo and noecho subroutines control software echo only. Hardware echo must remain disabled for the duration of the application, else the behaviour is undefined.

Return Values

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

Examples

1. To turn echoing on, use:

   echo();
   

2. To turn echoing off, use:

   noecho();
   

Implementation Specifics

These subroutines are part of Base Operating System (BOS) Runtime.

Related Information

The wgetch (getch, mvgetch, mvwgetch, or wgetch Subroutine) subroutine

Curses Overview for Programming in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines and Understanding Terminals with Curses in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.