addnwstr(3xcurses) [sunos man page]

addnwstr(3XCURSES)					  X/Open Curses Library Functions					addnwstr(3XCURSES)

NAME

       addnwstr, addwstr, mvaddnwstr, mvaddwstr, mvwaddnwstr, mvwaddwstr, waddnwstr, waddwstr - add a wide-character string to a window

SYNOPSIS

       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib 
       -R /usr/xpg4/lib -lcurses [ library... ]

       c89 [ flag... ] file... -lcurses [ library ... ]

       #include <curses.h>

       int addnwstr(const wchar_t *wstr, int n);

       int addwstr(const wchar_t *wstr);

       int mvaddnwstr(int y, int x, const wchar_t *wstr, int n);

       int mvaddwstr(int y, int x, const wchar_t *wstr);

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

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

       int waddnwstr(WINDOW*win, const wchar_t *wstr, int n);

       int waddwstr(WINDOW*win, const wchar_t *wstr);

DESCRIPTION

       The addwstr() function writes a null-terminated wide-character string  to the stdscr window at the current cursor position.  The waddwstr()
       function performs an identical action, but writes the  string to the window specified by win.  The mvaddwstr() and  mvwaddwstr()  functions
       write  the string to  the position indicated by the x (column) and y (row) parameters  (the former to the stdscr window; the latter to win-
       dow win).

       The addnwstr(), waddnwstr(), mvaddnwstr(), and  mvwaddnwstr() functions write at most n characters to the  window. If n is less than 0, the
       entire  string  is written.  The former two functions place the characters at the current cursor position;  the latter two commands use the
       position specified by the x and y parameters.

       All of these functions advance the cursor after writing the string.

       These functions are functionally equivalent to building a cchar_t from the wchar_t and the window rendition (or	background  character  and
       rendition)  and calling the wadd_wch(3XCURSES) function once for each  wchar_t in the string. Refer to the  curses(3XCURSES) man page for a
       complete description of	special character handling and of the interaction between the window rendition (or background character and rendi-
       tion) and the character written.

       Note that these functions differ from the add_wchnstr(3XCURSES) set of functions  in that the latter copy the string as is (without combin-
       ing each character  with the foreground and background attributes of the window).

PARAMETERS

       wstr	Is a pointer to the wide-character string that is to be written to the window.

       n	Is the maximum number of characters to be copied from wstr. If n is less than 0, the entire string is written or as much of it	as
		fits on the line.

       y	Is the y (row) coordinate of the starting position of wstr in the window.

       x	Is the x (column) coordinate of the starting position of wstr in  the window.

       win	Is a pointer to the window in which the string is to be written.

RETURN VALUES

       On success, these functions return OK. Otherwise, they return ERR.

ERRORS

       None.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       add_wch(3XCURSES), add_wchnstr(3XCURSES), curses(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)

SunOS 5.10							    5 Jun 2002							addnwstr(3XCURSES)

addnwstr(3XCURSES)					  X/Open Curses Library Functions					addnwstr(3XCURSES)

NAME

       addnwstr, addwstr, mvaddnwstr, mvaddwstr, mvwaddnwstr, mvwaddwstr, waddnwstr, waddwstr - add a wide-character string to a window

SYNOPSIS

       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib 
       -R /usr/xpg4/lib -lcurses [ library... ]

       c89 [ flag... ] file... -lcurses [ library ... ]

       #include <curses.h>

       int addnwstr(const wchar_t *wstr, int n);

       int addwstr(const wchar_t *wstr);

       int mvaddnwstr(int y, int x, const wchar_t *wstr, int n);

       int mvaddwstr(int y, int x, const wchar_t *wstr);

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

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

       int waddnwstr(WINDOW*win, const wchar_t *wstr, int n);

       int waddwstr(WINDOW*win, const wchar_t *wstr);

DESCRIPTION

       The addwstr() function writes a null-terminated wide-character string  to the stdscr window at the current cursor position.  The waddwstr()
       function performs an identical action, but writes the  string to the window specified by win.  The mvaddwstr() and  mvwaddwstr()  functions
       write  the string to  the position indicated by the x (column) and y (row) parameters  (the former to the stdscr window; the latter to win-
       dow win).

       The addnwstr(), waddnwstr(), mvaddnwstr(), and  mvwaddnwstr() functions write at most n characters to the  window. If n is less than 0, the
       entire  string  is written.  The former two functions place the characters at the current cursor position;  the latter two commands use the
       position specified by the x and y parameters.

       All of these functions advance the cursor after writing the string.

       These functions are functionally equivalent to building a cchar_t from the wchar_t and the window rendition (or	background  character  and
       rendition)  and calling the wadd_wch(3XCURSES) function once for each  wchar_t in the string. Refer to the  curses(3XCURSES) man page for a
       complete description of	special character handling and of the interaction between the window rendition (or background character and rendi-
       tion) and the character written.

       Note that these functions differ from the add_wchnstr(3XCURSES) set of functions  in that the latter copy the string as is (without combin-
       ing each character  with the foreground and background attributes of the window).

PARAMETERS

       wstr	Is a pointer to the wide-character string that is to be written to the window.

       n	Is the maximum number of characters to be copied from wstr. If n is less than 0, the entire string is written or as much of it	as
		fits on the line.

       y	Is the y (row) coordinate of the starting position of wstr in the window.

       x	Is the x (column) coordinate of the starting position of wstr in  the window.

       win	Is a pointer to the window in which the string is to be written.

RETURN VALUES

       On success, these functions return OK. Otherwise, they return ERR.

ERRORS

       None.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       add_wch(3XCURSES), add_wchnstr(3XCURSES), curses(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)

SunOS 5.10							    5 Jun 2002							addnwstr(3XCURSES)