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

개요

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

waddstr(3x)

curs_addstr(3x)                  Library calls                 curs_addstr(3x)

NAME
       addstr,  waddstr,  mvaddstr,  mvwaddstr,  addnstr, waddnstr, mvaddnstr,
       mvwaddnstr - add a string to a curses window and advance the cursor

SYNOPSIS
       #include <ncursesw/curses.h>

       int addstr(const char * str);
       int waddstr(WINDOW * win, const char * str);
       int mvaddstr(int y, int x, const char * str);
       int mvwaddstr(WINDOW * win, int y, int x, const char * str);

       int addnstr(const char * str, int n);
       int waddnstr(WINDOW * win, const char * str, int n);
       int mvaddnstr(int y, int x, const char * str, int n);
       int mvwaddnstr(WINDOW * win, int y, int x, const char * str,
             int n);

DESCRIPTION
       waddstr writes the characters of the (null-terminated)  string  str  to
       the  window  win,  as  if  by  calling waddch(3X) for each char in str.
       waddnstr is similar, but writes at most n  characters.   If  n  is  -1,
       waddnstr  writes the entire 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,

       •   str is a null pointer,

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

       •   an internal waddch(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 waddnstr 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.

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

HISTORY
       4BSD (1980) introduced waddstr along with its variants, the latter  de‐
       fined as macros.

       SVr3.1 (1987) added waddnstr (and its variants) redefining waddstr as a
       macro wrapping it.

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

       curses(3X), curs_addch(3X), curs_addchstr(3X)


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