|
|
HP-UX Reference > Ggetnstr(3X)ENHANCED CURSESHP-UX 11i Version 2: December 2007 Update |
|
NAMEgetnstr(), mvgetnstr(), mvwgetnstr(), wgetnstr() — get a multibyte character-length-limited string from the terminal SYNOPSIS#include <curses.h> int getnstr(char *str, int n); int mvgetnstr(int y, int x, char *str, int n); int mvwgetnstr(WINDOW *win, int y, int x, char *str, int n); int wgetnstr(WINDOW *win, char *str, int n); DESCRIPTIONThe effect of getnstr() and wgetnstr() is as though a series of calls to getch() were made, until a newline or carriage return is received. The resulting value is placed in the area pointed to by str. The getnstr() and wgetnstr() functions read at most n bytes, thus preventing a possible overflow of the input buffer. The user's erase and kill characters are interpreted, as well as any special keys (such as function keys, home key, clear key, and so on). The mvgetnstr() function is identical to getnstr() except that it is as though it is a call to move() and then a series of calls to getch(). The mvwgetnstr() function is identical to getnstr() except it is as though a call to wmove() is made and then a series of calls to wgetch(). The getnstr(), wgetnstr(), mvgetnstr(), and mvwgetnstr() functions will only return the entire multi-byte sequence associated with a character. If the array is large enough to contain at least one character, the functions fill the array with complete characters. If the array is not large enough to contain any complete characters, the function fails. |
|