curs_inch(3x) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

curs_inch(3x)

curs_inch(3x)                                                    curs_inch(3x)



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

SYNOPSIS
       #include <ncursesw/curses.h>

       chtype inch(void);
       chtype winch(WINDOW *win);

       chtype mvinch(int y, int x);
       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 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.

       l l .  A_CHARTEXT     Bit-mask to extract character A_ATTRIBUTES   Bit-
       mask to extract attributes  A_COLOR   Bit-mask  to  extract  color-pair
       field information

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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   library/ncurses = Stability Uncommitted


NOTES
       Note that all of these routines may be macros.

       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source   was    downloaded    from     https://invisible-mirror.net/ar‐
       chives/ncurses/ncurses-6.3.tar.gz.

       Further information about this software can be found on the open source
       community website at https://invisible-island.net/ncurses/.

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:

       ·   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.

       ·   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.

       curs_in_wch(3X)
            describes  comparable  functions for the wide-character (ncursesw)
            library.




                                                                 curs_inch(3x)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3