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

개요

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

curs_addstr(3x)

curs_addstr(3x)                                                curs_addstr(3x)



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

SYNOPSIS
       #include <ncursesw/curses.h>

       int addstr(const char *str);
       int addnstr(const char *str, int n);
       int waddstr(WINDOW *win, const char *str);
       int waddnstr(WINDOW *win, const char *str, int n);

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

DESCRIPTION
       These functions write the (null-terminated) character string str on the
       given window.  It is similar to calling waddch once for  each  byte  in
       the string.

       The mv functions perform cursor movement once, before writing any char‐
       acters.  Thereafter, the cursor is advanced as a side-effect of writing
       to the window.

       The  four  functions with n as the last argument write at most n bytes,
       or until a terminating null is reached.  If n is -1,  then  the  entire
       string will be added.

RETURN VALUE
       All functions return the integer ERR upon failure and OK on success.

       X/Open  does  not define any error conditions.  This implementation re‐
       turns an error

       ·   if the window pointer is null or

       ·   if the string pointer is null or

       ·   if the corresponding calls to waddch return an error.

       Functions with a “mv” prefix first  perform  a  cursor  movement  using
       wmove, and return an error if the position is outside the window, or if
       the window pointer is null.  If an error is returned by the  wmove,  no
       characters are added to the window.

       If  an  error  is  returned  by waddch (e.g., because the window is not
       large enough, or an illegal byte sequence was detected)  only  part  of
       the  string  may be added.  Aside from that, there is a special case in
       waddch where an error may be  returned  after  successfully  writing  a
       character  to  the lower-right corner of a window when scrollok is dis‐
       abled.


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 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/or‐
       acle/solaris-userland.  The original community  source  was  downloaded
       from  https://invisible-mirror.net/archives/ncurses/ncurses-6.3.tar.gz.

       Further information about this software can be found on the open source
       community website at https://invisible-island.net/ncurses/.

PORTABILITY
       These functions are described in the XSI Curses standard, Issue 4.

SEE ALSO
       curses(3X), curs_addch(3X).




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