curs_insch 3x

curs_insch(3x)                                           curs_insch(3x)




NAME 名前

       insch,  winsch,  mvinsch,  mvwinsch  -  insert a character
       before cursor in a curses window
       - curses ウインドウのカーソルの前に文字を挿入する


SYNOPSIS 書式

       #include <curses.h>

       int insch(chtype ch);
       int winsch(WINDOW *win, chtype ch);
       int mvinsch(int y, int x, chtype ch);
       int mvwinsch(WINDOW *win, int y, int x, chtype ch);


DESCRIPTION 説明

       These routines insert the character ch before the  charac-
       ter  under the cursor.  All characters to the right of the
       cursor are moved one space to the right, with  the  possi-
       bility  of the rightmost character on the line being lost.
       The insertion operation does not change the  cursor  posi-
       tion.
        これらのルーチンはカーソル位置にある文字の前に文字 ch を
       挿入します。
        カーソルの右側にある文字はすべてスペース 1 つ分ずつ
       右に移動し、行の右端の文字は失われる可能性があります。
        カーソルの位置は挿入動作によって変化しません。


RETURN VALUE 戻り値

       All  routines that return an integer return ERR upon fail-
       ure and OK (SVr4 specifies only "an  integer  value  other
       than  ERR")  upon  successful completion, unless otherwise
       noted in the preceding routine descriptions.
        上のルーチン説明で特記がない限り、整数を返すすべての
       ルーチンは、失敗のとき ERR を、正常終了のとき OK (SVr4 は
       「ERR 以外の整数値」としか指定していません) を返します。

       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 注意

       These routines do not necessarily imply use of a  hardware
       insert character feature.
        これらのルーチンは必ずしもハードウェアによる文字挿入機能を
       使うとは限りません。

       Note that insch, mvinsch, and mvwinsch may be macros.
        insch, mvinsch, mvwinsch はマクロであるかもしれないことに
       注意してください。


PORTABILITY 移植性

       These  functions are described in the XSI Curses standard,
       Issue 4.
        これらの関数は XSI Curses standard, Issue 4 に
       記載されています。
       
        訳注: ここには詳細が説明されていませんが、
       参考として X/Open Curses Issue 4, Version 2 では、
       文字とともにその色と属性も挿入します。
       また、行の折り返しはせず、原則として特殊文字の処理を行います。


SEE ALSO 関連項目

       curses(3x).

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




                                                         curs_insch(3x)