curs_inch 3x

curs_inch(3x)                                             curs_inch(3x)




NAME 名前

       inch,  winch,  mvinch,  mvwinch  -  get  a  character  and
       attributes from a curses window
       - curses ウインドウから文字と属性を取得する


SYNOPSIS 書式

       #include <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  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.
        これらのルーチンは、指定のウインドウのカーソルの
       現在位置にある文字を chtype 型で返します。
        その位置に属性が設定されていれば、戻り値にその属性値が
       論理和 (OR) されます。
        <curses.h> で定義されている定数と & (論理積 = AND) 演算子を
       使うと、文字または属性値を単独で取り出すことができます。


Attributes 属性値

       The  following  bit-masks  may  be  AND-ed with characters
       returned by winch.
        winch が返す文字と論理積 (AND) を取るために、次の
       ビットマスクを使うことができます。

       A_CHARTEXT     Bit-mask to extract character
       A_CHARTEXT     文字を取り出すためのビットマスク
       A_ATTRIBUTES   Bit-mask to extract attributes
       A_ATTRIBUTES   属性値を取り出すためのビットマスク
       A_COLOR        Bit-mask to extract color-pair field information
       A_COLOR        色のペアの部分を取り出すためのビットマスク


RETURN VALUE 戻り値

       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.
         mv で始まる関数は、最初に wmove を使用してカーソルを移動し、
       位置がウインドウの外だった場合、またはウインドウ・ポインタが
       ヌルの場合にエラーを返します。


NOTES 注意

       Note that all of these routines may be macros.
        これらのルーチンはすべてマクロであるかもしれないことに
       注意してください。


PORTABILITY 移植性

       These functions are described in the XSI Curses  standard,
       Issue 4.
        これらの関数は XSI Curses standard, Issue 4 に
       記載されています。


SEE ALSO 関連項目

       curses(3x).

       Comparable  functions  in  the  wide-character  (ncursesw)
       library are described in curs_in_wch(3x).
         ワイド文字用ライブラリ (ncursesw) の対応する関数群は 
       curs_in_wch(3x) で説明しています。



                                                          curs_inch(3x)