|
curs_add_wchstr(3)
Contents
|
curs_add_wchstr, add_wchstr, add_wchnstr, wadd_wchstr,
wadd_wchnstr, mvadd_wchstr, mvadd_wchnstr, mvwadd_wchstr,
mvwadd_wchnstr - Add an array of complex characters and
rendition to a Curses window
#include <curses.h>
int add_wchstr const(
cchar_t *wchstr ); int add_wchnstr(
const cchar_t *wchstr,
int n ); int wadd_wchstr(
WINDOW *win,
const cchar_t *wchstr ); int wadd_wchnstr(
WINDOW *win,
const cchar_t *wchstr,
int n ); int mvadd_wchstr(
int y,
int x,
const cchar_t *wchstr ); int mvadd_wchnstr(
int y,
int x,
const cchar_t *wchstr,
int n ); int mvwadd_wchstr(
WINDOW *win,
int y,
int x,
const cchar_t *wchstr ); int mvwadd_wchnstr(
WINDOW *win,
int y,
int x,
const cchar_t *wchstr,
int n );
Curses Library (libcurses)
Interfaces documented on this reference page conform to
industry standards as follows:
add_wchstr, wadd_wchstr, wadd_wchnstr, mvadd_wchstr,
mvadd_wchnstr, mvwadd_wchstr, mvwadd_wchnstr: XCURSES4.2
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
All of these functions copy wchstr, which points to an
array of complex characters, directly into the current or
specified window image structure starting at the current
cursor position or the position specified. The four functions
with n as the last argument copy at most n elements,
but no more than will fit on the line. If n=-1, then the
whole array is copied, to the maximum number that fit on
the line.
The position of the window cursor is not advanced. These
functions work faster than add_wstr because they merely
copy wchstr into the window image structure. On the other
hand, care must be taken when using these functions
because they do not perform any kind of checking for special
characters (such as for the newline character), they
do not advance the current cursor position, and they truncate
characters rather then wrapping them to the new line.
These functions end successfully on encountering a null
cchar_t. These functions also end successfully when they
fill the current line. If a character cannot completely
fit at the end of the current line, those columns are
filled with the background character and rendition.
The header file <curses.h> automatically includes the
header file <stdio.h>.
Note that all functions except wadd_wchnstr may be macros.
All functions return the integer OK upon successful completion.
Otherwise, they return ERR.
Functions: curses(3), curs_addwstr(3)
Others: standards(5)
curs_add_wchstr(3)
[ Back ] |