waddnwstr(3x) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

waddnwstr(3x)

curs_addwstr(3x)                 Library calls                curs_addwstr(3x)

NAME
       addwstr,   waddwstr,   mvaddwstr,   mvwaddwstr,   addnwstr,  waddnwstr,
       mvaddnwstr, mvwaddnwstr - add a wide-character string to a curses  win‐
       dow and advance the cursor

SYNOPSIS
       #include <ncursesw/curses.h>

       int addwstr(const wchar_t * wstr);
       int waddwstr(WINDOW * win, const wchar_t * wstr);
       int mvaddwstr(int y, int x, const wchar_t * wstr);
       int mvwaddwstr(WINDOW * win, int y, int x,
             const wchar_t * wstr);

       int addnwstr(const wchar_t * wstr, int n);
       int waddnwstr(WINDOW * win, const wchar_t * wstr, int n);
       int mvaddnwstr(int y, int x, const wchar_t * wstr, int n);
       int mvwaddnwstr(WINDOW * win, int y, int x,
             const wchar_t * wstr, int n);

DESCRIPTION
       waddwstr writes the characters of the (wide-null-terminated) wide-char‐
       acter  string  wstr  to the window win, as if by constructing a cchar_t
       for each wchar_t in wstr, then calling wadd_wch(3X) with the  resulting
       cchar_t.   curses  processes spacing and non-spacing characters in wstr
       one at a time.  waddnwstr is similar, but writes at most n wide charac‐
       ters.   If  n  is  -1,  waddnwstr  writes  the  entire   wide   string.
       ncurses(3X) describes the variants of these functions.

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,

       •   wstr is a null pointer,

       •   (for  functions  taking  a  WINDOW  pointer argument) win is a null
           pointer, or

       •   an internal wadd_wch(3X) call returns ERR.

       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 waddnwstr 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.

       SVr4 describes a successful return value  only  as  “an  integer  value
       other than ERR”.

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 waddwstr and waddnwstr (and the usual variants).  These
       were later additions to SVr4.x, not appearing in the first SVr4 (1989).

SEE ALSO
       curs_addstr(3X)  describes  comparable functions of the ncurses library
       in its non-wide-character configuration.

       curses(3X), curs_add_wch(3X), curs_add_wchstr(3X)


ncurses 6.5                       2025-03-15                  curs_addwstr(3x)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3