add_wchstr man page on Solaris

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

add_wchnstr(3XCURSES)	X/Open Curses Library Functions	 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
		       window.

       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 wchstr  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)

SunOS 5.10			  5 Jun 2002		 add_wchnstr(3XCURSES)
[top]

List of man pages available for Solaris

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