ungetcharacter

Pushes a character to the push-back buffer of the application screen.

Library:LibC

Classification:Novell

Service:Screen Support

Syntax

  #include <screen.h> 
   
  int ungetcharacter (
     int   ch);

If successful, returns 0. Otherwise, returns -1 and sets errno to one of the following:

Decimal	Constant	Description
19	EWRNGKND	The wrong kind of operation is being attempted on the wrong kind of object.
23	ENO_SCRNS	Screen I/O is being attempted when no screen is available.
105	ENOCONTEXT	No thread context is present.

The pushed-back character is the next character read during a call to such functions as getcharacter or getstring.