X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_inchstr.3x.html;h=bcc7edac8269f5794fcd73adf9d01b38804e9cf4;hp=2eb84bc7e4a17f855182c57f2a3b0c5df642bb92;hb=ed646e3f683083e787c6ba773364401dc9fa9d40;hpb=6208c89f98f1cf9fe0980bd8e791846ce007a13d;ds=sidebyside diff --git a/doc/html/man/curs_inchstr.3x.html b/doc/html/man/curs_inchstr.3x.html index 2eb84bc7..bcc7edac 100644 --- a/doc/html/man/curs_inchstr.3x.html +++ b/doc/html/man/curs_inchstr.3x.html @@ -1,6 +1,6 @@ @@ -40,15 +40,15 @@

curs_inchstr 3x

-curs_inchstr(3x)                                       curs_inchstr(3x)
+curs_inchstr(3x)                                              curs_inchstr(3x)

NAME

-       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

SYNOPSIS

@@ -61,61 +61,58 @@
        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 mvwinchnstr(WINDOW *win, int y, int x, chtype *chstr, int n);

DESCRIPTION

-       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  character or the attribute alone from any position in
-       the chstr [see curs_inch(3x)].
+       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  character
+       or   the   attribute   alone  from  any  position  in  the  chstr  [see
+       curs_inch(3x)].

RETURN VALUE

-       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).
+       All routines return the integer ERR upon failure and an  integer  value
+       other than ERR upon successful completion (the number of characters re-
+       trieved, 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.
+       X/Open Curses defines no error conditions.  In this implementation:
 
-       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.
+       o   If the win parameter is null, an error is returned,
+
+       o   If the chstr parameter is null, an error is returned,
+
+       Functions with a "mv" prefix first  perform  a  cursor  movement  using
+       wmove, and return an error if the position is outside the window, or if
+       the window pointer is null.

NOTES

-       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.
+       Note that all routines except winchnstr may be macros.  SVr4  does  not
+       document whether the result string is zero-terminated; it does not doc-
+       ument whether a length limit argument includes any trailing 0;  and  it
+       does not document the meaning of the return value.

PORTABILITY

-       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.
+       These  functions are described in the XSI Curses standard, Issue 4.  It
+       is no more specific than the SVr4 documentation on the trailing 0.   It
+       does specify that the successful return of the functions is OK.