addwchnstr man page on DigitalUNIX

Printed from

curs_addwchstr(3)					     curs_addwchstr(3)

       curs_addwchstr,	addwchstr,  addwchnstr, waddwchstr, waddwchnstr, mvad‐
       dwchstr, mvaddwchnstr, mvwaddwchstr, mvwaddwchnstr - Add	 a  string  of
       wchar_t characters (and attributes) to a Curses window

       #include <curses.h>

       int addwchstr(
	       chtype *wchstr ); int addwchnstr(
	       chtype *wchstr,
	       int n ); int waddwchstr(
	       WINDOW *win,
	       chtype *wchstr ); int waddwchnstr(
	       WINDOW *win,
	       chtype *wchstr,
	       int n ); int mvaddwchstr(
	       int y,
	       int x,
	       chtype *wchstr ); int mvaddwchnstr(
	       int y,
	       int x,
	       chtype *wchstr,
	       int n ); int mvwaddwchstr(
	       WINDOW *win,
	       int y,
	       int x,
	       chtype *wchstr ); int mvwaddwchnstr(
	       WINDOW *win,
	       int y,
	       int x,
	       chtype *wchstr,
	       int n );

       Curses Library (libcurses)

       All  of these routines copy wchstr, which points to a string of wchar_t
       characters, directly into the window image structure  starting  at  the
       current	or specified cursor position.  The four routines with n as the
       last argument copy at most n elements, but no more than will fit on the
       line. If n=-1, then all the routines copy the whole string, to the max‐
       imum number that fit on the line or until a null terminator is reached.

       The routines do not advance the position of  the	 window	 cursor.  They
       work  faster  than  waddnwstr  because they merely copy wchstr into the
       window image structure. On the other hand,  care	 must  be  taken  when
       using these functions because they: Do not perform any kind of checking
       (such as for the newline character) Do not advance the  current	cursor
       position Truncate the string, rather then wrapping it around to the new

       The header file	<curses.h>  automatically  includes  the  header  file

       Note that all routines except waddwchnstr may be macros.

       The routines described on this reference page are among the MNLS Curses
       functions that are not included in the X/Open Curses CAE specification.
       MNLS  routines  are  supported only for backward compatibility reasons.
       For new applications, use the routines described on  the	 add_wchstr(3)
       reference page.

       All  routines  return the integer ERR upon failure and an integer value
       other than ERR upon successful completion, unless  otherwise  noted  in
       the preceding routine descriptions.

       Functions: curses(3), add_wchstr(3)


List of man pages available for DigitalUNIX

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]
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