addnwstr man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

ADDNWSTR(3XCURSES)					    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 posi‐
       tion 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 ren‐
       dition)	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 interac‐
       tion  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 combining
       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	 writ‐
	       ten.

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)

				  Jun 5, 2002		    ADDNWSTR(3XCURSES)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net