getstr(3cur)getstr(3cur)Name
getstr, mvgetstr, mvwgetstr, wgetstr - read string
Syntax
#include <cursesX.h>
int getstr(str)
char ∗str;
int wgetstr(win, str)
WINDOW ∗win;
char ∗str;
int mvgetstr(y, x, str)
int y, x;
char ∗str;
int mvwgetstr(win, y, x, str)
WINDOW ∗win;
int y, x;
char ∗str;
Description
The routine reads characters from the terminal associated with the
default window and stores them in a buffer until a carriage return or
newline is received from The routine B is called by to read each char‐
acter.
The routine reads characters from the terminal associated with the
specified window. The characters are read from the current cursor
position until a newline or carriage return is received.
The routine reads characters from the terminal associated with the
default window. The characters are read from the specified cursor
position until a newline or carriage return is received.
The routine reads characters from the terminal associated with the
specified window. The characters are read from the specified cursor
position until a newline or carriage return is received.
The following information applies to all the routines.
The resulting string is placed in the area pointed to by the character
pointer The user's erase and kill characters are interpreted. The area
used to hold the string is assumed to be large enough to handle it, as
does not check for buffer overflow. If the area is not large enough,
the result will be unpredictable.
The routines and are macros.
Return Values
The and functions return OK on success and ERR on error.
See Alsogetch(3cur)getstr(3cur)