svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
curs_add_wchstr(3x)
curs_add_wchstr(3x) Library calls curs_add_wchstr(3x)
NAME
add_wchstr, wadd_wchstr, mvadd_wchstr, mvwadd_wchstr, add_wchnstr,
wadd_wchnstr, mvadd_wchnstr, mvwadd_wchnstr - add a curses complex
character string to a window
SYNOPSIS
#include <ncursesw/curses.h>
int add_wchstr(const cchar_t * wchstr);
int wadd_wchstr(WINDOW * win, const cchar_t * wchstr);
int mvadd_wchstr(int y, int x, const cchar_t * wchstr);
int mvwadd_wchstr(WINDOW * win, int y, int x,
const cchar_t * wchstr);
int add_wchnstr(const cchar_t * wchstr, int n);
int wadd_wchnstr(WINDOW * win, const cchar_t * wchstr,
int n);
int mvadd_wchnstr(int y, int x, const cchar_t * wchstr,
int n);
int mvwadd_wchnstr(WINDOW * win, int y, int x,
const cchar_t * wchstr, int n);
DESCRIPTION
wadd_wchstr copies the string of complex characters wchstr to the win‐
dow win. A null complex character terminates the string. If a complex
character does not completely fit at the end of the line, curses fills
its remaining cells with the window's background character; see
bkgrnd(3X). wadd_wchnstr does the same, but copies at most n charac‐
ters, or as many as possible if n is -1. ncurses(3X) describes the
variants of these functions.
Because these functions do not call wadd_wch(3X) internally, they are
faster than waddwstr(3X) and waddnwstr(3X). On the other hand, they
• do not treat the backspace, carriage return, or line feed charac‐
ters specially;
• do not represent unprintable characters with wunctrl(3X);
• do not update the cursor position to follow the last character
written;
• truncate the string at the window's right margin, rather than wrap‐
ping it to the next line and potentially scrolling.
RETURN VALUE
These functions return OK on success and ERR on failure.
In ncurses, these functions fail if
• the curses screen has not been initialized,
• wchstr is a null pointer, or
• (for functions taking a WINDOW pointer argument) win is a null
pointer.
Functions prefixed with “mv” first perform cursor movement and fail if
the position (y, x) is outside the window boundaries.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
ity library/ncurses = Stability Uncommitted
NOTES
All of these functions except wadd_wchnstr may be implemented as
macros.
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at:
https://github.com/oracle/solaris-userland
The original community source was downloaded from:
https://invisible-mirror.net/archives/ncurses/cur‐
rent/ncurses-6.5-20250614.tgz
Further information about this software can be found on the open source
community website at https://invisible-island.net/ncurses/.
PORTABILITY
X/Open Curses Issue 4 describes these functions. It specifies no error
conditions for them.
HISTORY
X/Open Curses Issue 4 (1995) initially specified these functions. The
System V Interface Definition Version 4 of the same year specified
functions named waddwchstr and waddwchnstr (and the usual variants).
These were later additions to SVr4.x, not appearing in the first SVr4
(1989). They differed from X/Open's later wadd_wchstr and wadd_wchnstr
in that they each took an argument of type wchar_t instead of cchar_t.
SEE ALSO
curs_addchstr(3X) describes comparable functions of the ncurses library
in its non-wide-character configuration.
curses(3X), curs_addwstr(3X), curs_add_wch(3X)
ncurses 6.5 2025-03-15 curs_add_wchstr(3x)