getstring

Retrieves a string from the keyboard of the application screen as long as the application screen is not identical to the System Console or System Logger screen.

Library:LibC
Classification:Novell
Service:Screen Support

Syntax

  #include <screen.h> 
   
  char *getstring (
     char    *string,
     size_t   max,
     int      display);
  

Parameters

string

(OUT) Points to a null-terminated string.

max

(IN) Specifies the maximum length of the string (1 to 255).

display

(IN) Specifies whether the text in the string is displayed on the screen.

  • TRUE display the text
  • FALSE do not display the text

Return Values

If successful, returns a string. Otherwise, returns a NULL pointer and sets errno to one of the following:

Decimal

Constant

Description

9

EINVAL

The max parameter is invalid.

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.

See Also

putstring