名前 | 形式 | 機能説明 | 戻り値 | 属性 | 関連項目 | 注意事項
cc [ flag ... ] file ... -lcurses [ library .. ] #include <curses.h>int inswstr(wchar_t *wstr);
これらのルーチンは、wchar_t 文字列を現カーソル位置の文字の直前に挿入します。挿入可能な最大文字数は、その行に入りきる数です。挿入によりカーソルの右側にある文字は右に移動し、その結果行の右端の何文字かが失われる可能性もあります。カーソル位置は ( y、x が指定されていればその位置に移動後) 変更されません。なお、これはハードウェアの文字挿入機構を使用するということを意味するものではありません。最終引数として n を指定する 4 つのルーチンは、最大 n 個の wchar_t 文字をコピーします。n<=0 の場合、文字列全体をコピーします。
wstr 中にタブ、復帰改行 (newline)、キャリッジリターン、またはバックスペース文字が含まれていると、カーソルはウィンドウ内で移動してその文字で指定された位置に置かれます。なお復帰改行の場合には、カーソル移動に先立って clrtoeol(3CURSES) が行われます。タブ位置は 8 カラムごとに設定されていると見なされます。wstr 中に他の制御文字がある場合、‸X 形式で描かれます。制御文字を追加した後 (さらに必要ならばカーソルをその位置に移動した後) で winwch(3CURSES) を呼び出しても制御文字自体は返されません。その代わりに制御文字の表示内容が返されます。
上記ルーチンはすべて、エラーが発生すれば整数 ERR を返し、正常に終了すれば ERR 以外の整数値を返します。
次の属性については attributes(5) のマニュアルページを参照してください。
属性タイプ | 属性値 |
---|---|
MT レベル | Unsafe |
ヘッダーファイル <curses.h> は自動的に <stdio.h>、<unctrl.h>、および <widec.h> ヘッダーファイルを含みます。 winsnwstr() 以外のルーチンはマクロにすることも可能です。