Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
addchstr(3XCURSES)	X/Open Curses Library Functions	    addchstr(3XCURSES)

NAME
       addchstr,  addchnstr,  mvaddchstr, mvaddchnstr, mvwaddchnstr, mvwaddch-
       str, waddchstr, waddchnstr - copy a character string (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 addchstr(const chtype *chstr);

       int addchnstr(const chtype *chstr, int n);

       int mvaddchnstr(int y, int x, const chtype *chstr, int n);

       int mvaddchstr(int y, int x, const chtype *chstr);

       int  mvwaddchnstr(WINDOW	 *win,	int y, int x, const chtype *chstr, int
       n);

       int mvwaddchstr(WINDOW *win, int	y, int x, const	chtype *chstr);

       int waddchstr(WINDOW *win, const	chtype *chstr);

       int waddchnstr(WINDOW *win, const chtype	*chstr,	int n);

DESCRIPTION
       The addchstr() function copies the chtype character string to the  std-
       scr window at the current cursor	position.  The mvaddchstr() and	mvwad-
       dchstr()	functions copy the  character 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 waddchstr() is  identi-
       cal to addchstr(), but writes  to the window specified by win.

       The addchnstr(),	waddchnstr(), mvaddchnstr(), and  mvwaddchnstr() func-
       tions 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 addstr(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 is not	combined with the character;  only the attributes that
       are already part	of the chtype character	 are used.

PARAMETERS
       chstr	Is a pointer to	the chtype string to be	copied to the window.

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

       x	Is the x (column) coordinate of	the starting position of chstr
		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
       addch(3XCURSES),		 addnstr(3XCURSES),	    attroff(3XCURSES),
       libcurses(3XCURSES), attributes(5), standards(5)

SunOS 5.10			  5 Jun	2002		    addchstr(3XCURSES)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=waddchstr&sektion=3xcurses&manpath=SunOS+5.10>

home | help