X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;ds=inline;f=doc%2Fhtml%2Fman%2Fcurs_inchstr.3x.html;h=73a78fc9c5c04be82e0f5ae6f58b0c06d4a2cf4d;hb=7ca9d1eb1a8a995514d4dee312bf136fba88ec62;hp=5688c02aa2e235c2d4df1b79e28b2c0511376e56;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34;p=ncurses.git diff --git a/doc/html/man/curs_inchstr.3x.html b/doc/html/man/curs_inchstr.3x.html index 5688c02a..73a78fc9 100644 --- a/doc/html/man/curs_inchstr.3x.html +++ b/doc/html/man/curs_inchstr.3x.html @@ -1,58 +1,108 @@ + + +
++curs_inchstr(3x) curs_inchstr(3x) + + +
- 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). + No error conditions are defined. If the chstr parameter + is null, no data is returned, and the return value is ze- + ro. + + Functions with a "mv" prefix first perform a cursor move- + ment using wmove, and return an error if the position is + outside the window, or if the window pointer is null. +
- 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 - meaning of the return value. + Note that all routines except winchnstr may be macros. + SVr4 does not document whether the result string is zero- + terminated; it does not document whether a length limit + argument includes any trailing 0; and it does not document + the meaning of the return value.@@ -60,16 +110,19 @@ 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). + Comparable functions in the wide-character (ncursesw) li- + brary are described in curs_in_wchstr(3x). + curs_inchstr(3x)