X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_inchstr.3x.html;h=cdf33a2a5793e3690ad4c8fd783cd2533f417f52;hp=5688c02aa2e235c2d4df1b79e28b2c0511376e56;hb=46722468f47c2b77b3987729b4bcf2321cccfd01;hpb=c633e5103a29a38532cf1925257b91cea33fd090 diff --git a/doc/html/man/curs_inchstr.3x.html b/doc/html/man/curs_inchstr.3x.html index 5688c02a..cdf33a2a 100644 --- a/doc/html/man/curs_inchstr.3x.html +++ b/doc/html/man/curs_inchstr.3x.html @@ -1,54 +1,92 @@ + + +
+- inchstr, inchnstr, winchstr, winchnstr, mvinchstr, - mvinchnstr, mvwinchstr, mvwinchnstr - get a string of - characters (and attributes) from a curses window + inchstr, inchnstr, winchstr, winchnstr, mvinchstr, + mvinchnstr, mvwinchstr, mvwinchnstr - get a string of + characters (and attributes) from a curses window
- #include <curses.h> + #include <curses.h> - int inchstr(chtype *chstr); - int inchnstr(chtype *chstr, int n); - int winchstr(WINDOW *win, chtype *chstr); - int winchnstr(WINDOW *win, chtype *chstr, int n); - int mvinchstr(int y, int x, chtype *chstr); - int mvinchnstr(int y, int x, chtype *chstr, int n); - int mvwinchstr(WINDOW *win, int y, int x, chtype *chstr); - int mvwinchnstr(WINDOW *win, int y, int x, chtype *chstr, - int n); + int inchstr(chtype *chstr); + int inchnstr(chtype *chstr, int n); + int winchstr(WINDOW *win, chtype *chstr); + int winchnstr(WINDOW *win, chtype *chstr, int n); + int mvinchstr(int y, int x, chtype *chstr); + int mvinchnstr(int y, int x, chtype *chstr, int n); + int mvwinchstr(WINDOW *win, int y, int x, chtype *chstr); + int mvwinchnstr(WINDOW *win, int y, int x, chtype *chstr, + int n);
- These routines return a NULL-terminated array of chtype + These routines return a NULL-terminated array of chtype quantities, starting at the current cursor position in the named window and ending at the right margin of the window. - The four functions with n as the last argument, return a - leading substring at most n characters long (exclusive of - the trailing (chtype)0). Constants defined in <curses.h> - can be used with the & (logical AND) operator to extract + The four functions with n as the last argument, return a + leading substring at most n characters long (exclusive of + the trailing (chtype)0). Constants defined in <curses.h> + can be used with the & (logical AND) operator to extract the character or the attribute alone from any position in - the chstr [see curs_inch(3x)]. + the chstr [see curs_inch(3x)].
- All routines return the integer ERR upon failure and an - integer value other than ERR upon successful completion + All routines return the integer ERR upon failure and an + integer value other than ERR upon successful completion (the number of characters retrieved, exclusive of the trailing 0).
- Note that all routines except winchnstr may be macros. + Note that all routines except winchnstr may be macros. SVr4 does not document whether the result string is 0-ter- minated; it does not document whether a length limit argu- ment includes any trailing 0; and it does not document the @@ -60,12 +98,12 @@ These functions are described in the XSI Curses standard, Issue 4. It is no more specific than the SVr4 documenta- tion on the trailing 0. It does specify that the success- - ful return of the functions is OK. + ful return of the functions is OK.
- curses(3x), curs_inch(3x). + curses(3x), curs_inch(3x).