名前 | 形式 | 機能説明 | 戻り値 | 属性 | 関連項目 | 注意事項
#include<curses.h>int addwchstr(chtype *wchstr);
上記ルーチンはいずれも wchar_t 文字列をポイントする wchstr を、ウィンドウイメージ構造体中の現カーソル位置に直接コピーします。最終引数として n を指定する 4 つのルーチンは、最大 n 個のエレメントをコピーします。ただし行の長さを超えてコピーすることはありません。n=–1 の場合、行に入りきる限り文字列全体を繰り返してコピーします。
ウィンドウカーソルの位置は移動しません。これらのルーチンは、単に wchstr をウィンドウイメージ構造体にコピーするだけなので、waddnwstr(3CURSES) よりは処理速度が速くなります。ただし注意すべきことは、復帰改行文字 (newline) があるかなどといったチェックはいっさいしないこと、現カーソル位置を進めないこと、そして行の終わりでは文字列のはみ出した分を (次の行に回さずに) そこで切り捨ててしまうことです。
上記ルーチンはすべて、エラーが発生すれば整数 ERR を返し、正常に終了すれば ERR 以外の整数値を返します (それ以外の動作が本項内で記述されている場合を除く)。
次の属性については attributes(5) のマニュアルページを参照してください。
属性タイプ | 属性値 |
---|---|
MT レベル | Unsafe |
ヘッダーファイル <curses.h> は自動的に <stdio.h>、<unctrl.h>、および <widec.h> ヘッダーファイルを含みます。
waddwchnstr() 以外のルーチンはマクロにすることも可能です。 これらのルーチンは、chtype 中でカラー属性を扱うことはできません。