EN JA
curs_inwstr(3X)
curs_inwstr(3X) curs_inwstr(3X)

名称

inwstr, innwstr, winwstr, winnwstr, mvinwstr, mvinnwstr, mvwinwstr, mvwinnwstr - curses ウィンドウから wchar_t の文字列を取得する

書式


#include <curses.h>
 

int inwstr( wchar_t * str );
 

int innwstr( wchar_t * str , int n );
 

int winwstr( WINDOW * win , wchar_t * str );
 

int winnwstr( WINDOW * win , wchar_t * str , int n );
 

int mvinwstr( int y , int x , wchar_t * str );
 

int mvinnwstr( int y , int x , wchar_t * str , int n );
 

int mvwinwstr( WINDOW * win , int y , int x , wchar_t * str );
 

int mvwinnwstr( WINDOW * win , int y , int x , wchar_t * str , int n );

解説

これらのルーチンは、指定されたウィンドウの現在のカーソル位置で始まる wchar_t の文字列を wstr に抽出して返します。訳注: 書式の str が wstr の間違いと思われる。属性は文字から取り除かれます。最後の引数として n がある 4 つの関数は、(後続するヌル文字を除いて) 先頭の n バイトの部分文字列を返します。転送は、現在行の終り、または、 wstr によって参照される位置に n バイトが格納されたとき、停止します。

サイズ n が全部の文字を格納できるほど大きくないなら、エラーが生成されます。

winnwstr を除いて、すべてのルーチンがマクロであるかもしれないことに注意してください。

戻り値

すべてのルーチンは、失敗すれば ERR を返します。成功して終了すれば、 * inwstr ルーチンは、 OK を返し、* innwstr ルーチンは、文字列に読み込んだ文字の数を返します。

関連項目

curses(3X), curs_instr(3X), curs_in_wchstr(3X)