NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | SEE ALSO
#include <curses.h>int inchnstr(chtype *chstr, int n);
The inchstr() and winchstr() functions retrieve the character string (with rendition) starting at the current cursor position of the stdscr window and window win , respectively, and ending at the right margin. The mvinchstr() and mvwinchstr() functions retrieve the character string located at the position indicated by the x (column) and y (row) parameters (the former in the stdscr window; the latter in window win ).
The inchnstr() , winchnstr() , mvinchnstr() , and mvwinchnstr() functions retrieve at most n characters from the window stdscr and win , respectively. The former two functions retrieve the string, starting at the current cursor position; the latter two commands retrieve the string, starting at the position specified by the x and y parameters.
All these functions store the retrieved character string in the object pointed to by chstr .
The complete character/attribute pair is retrieved. The character or attributes can be extracted by performing a bitwise AND on the retrieved value, using the constants A_CHARTEXT , A_ATTRIBUTES , and A_COLOR . The character string can also be retrieved without attributes by using instr(3XCURSES) set of functions.
Is a pointer to an object that can hold the retrieved character string.
Is the number of characters not to exceed when retrieving chstr .
Is the y (row) coordinate of the starting position of the string to be retrieved.
Is the x (column) coordinate of the starting position of the string to be retrieved.
Is a pointer to the window in which the string is to be retrieved.
On success, these functions return OK . Otherwise, they return ERR .
None.
NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | SEE ALSO