X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_inch.3x.html;h=f54519414bad3ebf482b974cef8d0992ecbb96ff;hp=d601804e283e3c4236f9dcf3e5627fd007c38586;hb=d97989d1e0db7282c723cabb44b991b951790006;hpb=027ae42953e3186daed8f3882da73de48291b606 diff --git a/doc/html/man/curs_inch.3x.html b/doc/html/man/curs_inch.3x.html index d601804e..f5451941 100644 --- a/doc/html/man/curs_inch.3x.html +++ b/doc/html/man/curs_inch.3x.html @@ -1,8 +1,7 @@ - + + + curs_inch 3x - + -

curs_inch 3x

-
+

curs_inch 3x

-
-curs_inch(3x)                                             curs_inch(3x)
+curs_inch(3x)                                                    curs_inch(3x)
 
 
 
 
-
-

NAME

-       inch,  winch,  mvinch,  mvwinch  -  get  a  character  and
-       attributes from a curses window
+

NAME

+       inch,  winch,  mvinch,  mvwinch - get a character and attributes from a
+       curses window
 
 
-
-

SYNOPSIS

+

SYNOPSIS

        #include <curses.h>
 
        chtype inch(void);
@@ -62,50 +60,93 @@
        chtype mvwinch(WINDOW *win, int y, int x);
 
 
-
-

DESCRIPTION

-       These routines return the character, of  type  chtype,  at
-       the   current  position  in  the  named  window.   If  any
-       attributes are set for that  position,  their  values  are
-       OR'ed  into  the  value  returned.   Constants  defined in
-       <curses.h> can be used with the & (logical  AND)  operator
-       to extract the character or attributes alone.
-
-   Attributes
-       The  following  bit-masks  may  be  AND-ed with characters
-       returned by winch.
+

DESCRIPTION

+       These routines return the character, of type  chtype,  at  the  current
+       position in the named window.  If any attributes are set for that posi-
+       tion, their values  are  OR'ed  into  the  value  returned.   Constants
+       defined  in <curses.h> can be used with the & (logical AND) operator to
+       extract the character or attributes alone.
+
+
+

Attributes

+       The following bit-masks may  be  AND-ed  with  characters  returned  by
+       winch.
 
        A_CHARTEXT     Bit-mask to extract character
        A_ATTRIBUTES   Bit-mask to extract attributes
        A_COLOR        Bit-mask to extract color-pair field information
 
 
-
-

NOTES

+

RETURN VALUE

+       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.
+
+       The  winch  function  does  not  return an error if the window contains
+       characters larger than 8-bits (255).  Only the low-order 8 bits of  the
+       character are used by winch.
+
+
+

NOTES

        Note that all of these routines may be macros.
 
 
-
-

PORTABILITY

-       These functions are described in the XSI Curses  standard,
-       Issue 4.
+

PORTABILITY

+       These functions are described in the XSI Curses standard, Issue 4.
 
+       Very  old systems (before standardization) provide a different function
+       with the same name:
 
-
-

SEE ALSO

-       curses(3x).
+       o   The winch function was part of the  original  BSD  curses  library,
+           which   stored   a  7-bit  character  combined  with  the  standout
+           attribute.
+
+           In BSD curses, winch returned only the character  (as  an  integer)
+           with the standout attribute removed.
+
+       o   System  V  curses  added support for several video attributes which
+           could be combined with characters in the window.
+
+           Reflecting this improvement, the function was altered to return the
+           character combined with all video attributes in a chtype value.
+
+       X/Open Curses does not specify the size and layout of attributes, color
+       and character values in chtype; it is  implementation-dependent.   This
+       implementation  uses 8 bits for character values.  An application using
+       more bits, e.g., a Unicode value, should use the wide-character equiva-
+       lents to these functions.
+
+
+

SEE ALSO

+       curses(3x)
+            gives an overview of the WINDOW and chtype data types.
+
+       curs_attr(3x)
+            goes  into more detail, pointing out portability problems and con-
+            straints on the use of chtype for returning window information.
 
-       Comparable  functions  in  the  wide-character  (ncursesw)
-       library are described in curs_in_wch(3x).
+       curs_in_wch(3x)
+            describes comparable functions for the  wide-character  (ncursesw)
+            library.
 
 
 
-                                                          curs_inch(3x)
+                                                                 curs_inch(3x)
-
-
-Man(1) output converted with -man2html -
+
+ +