add_wchnstr man page on SmartOS

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

ADD_WCHNSTR(3XCURSES)					 ADD_WCHNSTR(3XCURSES)

NAME
       add_wchnstr,  add_wchstr,  mvadd_wchnstr, mvadd_wchstr, mvwadd_wchnstr,
       mvwadd_wchstr, wadd_wchnstr, wadd_wchstr - copy	a  string  of  complex
       characters (with renditions) 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 add_wchnstr(const cchar_t *wchstr, int n);

       int add_wchstr(const cchar_t *wchstr);

       int mvadd_wchnstr(int y, int x, const cchar_t *wchstr, int n);

       int mvadd_wchstr(int y, int x, const cchar_t *wchstr);

       int mvwadd_wchnstr(WINDOW *win, int y, int x,
	    const cchar_t *wchstr, int n);

       int mvwadd_wchstr(WINDOW *win, int y, int x, const cchar_t *wchstr);

       int wadd_wchstr(WINDOW *win, const cchar_t *wchstr);

       int wadd_wchnstr(WINDOW *win, const cchar_t *wchstr, int n);

DESCRIPTION
       The  add_wchstr()  function  copies the string of cchar_t characters to
       the stdscr window at the current cursor position.   The	mvadd_wchstr()
       and mvwadd_wchstr() functions copy the  string to the starting position
       indicated by the x (column) and y  (row) parameters (the former to  the
       stdscr window; the latter to window win).  The wadd_wchstr() is identi‐
       cal to add_wchstr(), but writes	to the window specified by win.

       The add_wchnstr(), wadd_wchnstr(),  mvadd_wchnstr(),  and  mvwadd_wchn‐
       str()  functions	 write n characters to the window,  or as many as will
       fit on the line. If n is less than 0, the entire string is written,  or
       as much of it as	 fits on the line.  The former two functions place the
       string at the current cursor position; the  latter two commands use the
       position specified by the x and y parameters.

       These  functions	 differ from the addwstr(3XCURSES) set of functions in
       two important respects. First, these functions do not advance the  cur‐
       sor after writing the  string to the window. Second, the current window
       rendition (that is, the combination of attributes  and color  pair)  is
       not  combined  with  the	 character;  only  those  attributes that  are
       already part of the cchar_t character are used.

PARAMETERS
       wchstr
		 Is a pointer to the cchar_t string to be copied to  the  win‐
		 dow.

       n
		 Is the maximum number of characters to be copied from wchstr.
		 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 wchstr
		 in the window.

       x
		 Is the x (column) coordinate of the starting position of wch‐
		 str  in the window.

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

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
       addnwstr(3XCURSES),	 add_wch(3XCURSES),	   attr_off(3XCURSES),
       libcurses(3XCURSES), attributes(5), standards(5)

				  Jun 5, 2002		 ADD_WCHNSTR(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