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

개요

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

winch(3x)

curs_inch(3x)                    Library calls                   curs_inch(3x)

NAME
       inch, winch, mvinch, mvwinch - get a curses character from a 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
       winch  returns the curses character, including its attributes and color
       pair identifier, at the cursor position in the window win.   Subsection
       “Video  Attributes”  of  attron(3X)  explains how to extract these data
       from a chtype.  ncurses(3X) describes the variants of this function.

RETURN VALUE
       These functions return OK on success and ERR on failure.

       In ncurses, they return ERR if win is NULL.

       Functions prefixed with “mv” first perform cursor movement and fail  if
       the position (y, x) is outside the window boundaries.


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
       inch, mvinch, and mvwinch may be implemented as macros.

       These functions do not fail if the window contains cells of curses com‐
       plex  characters;  that is, if they contain characters with codes wider
       than eight bits (or greater than 255 as an unsigned  decimal  integer).
       They  instead  extract  only  the low-order eight bits of the character
       code from the cell.

       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/archives/ncurses/cur‐
       rent/ncurses-6.5-20250614.tgz

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

PORTABILITY
       X/Open Curses Issue 4 describes these functions.  It specifies no error
       conditions for them.

HISTORY
       The  original  curses in 4BSD (1980) defined winch as a macro accessing
       the WINDOW structure member representing character cell data,  at  that
       time a char, containing only a 7-bit ASCII character code and a “stand‐
       out“ attribute bit, the only one the library supported.

       SVr2  curses (1984) extended this approach, widening the character code
       to eight bits and permitting several attributes to be combined with  it
       by  storing them together in a chtype, an alias of unsigned short.  Be‐
       cause a macro was used, its value was not type-checked  as  a  function
       return  value  could have been.  Goodheart documented SVr3 (1987) winch
       as returning an int.  SVr3.1's (1987) chtype became  an  alias  of  un‐
       signed long, using 16 bits for the character code and widening the type
       in  practical  terms to 32 bits, as 64-bit Unix systems were not yet in
       wide use, and fixed-width integral types would not  be  standard  until
       ISO  C99.   SVr3.2 (1988) added a 6-bit color pair identifier alongside
       the attributes.

SEE ALSO
       curs_in_wch(3X) describes comparable functions of the  ncurses  library
       in its wide-character configuration (ncursesw).

       curses(3X), curs_instr(3X)


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