[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    curs_addwstr(3X) manual page Table of Contents

Name

curs_addwstr, addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr, mvaddnwstr, mvwaddwstr, mvwaddnwstr - add a string of wchar_t characters to a curses window and advance cursor

Synopsis

cc [ flag ... ] file ... -lcurses [ library .. ]
#include <curses.h>

int addwstr(wchar_t *wstr);

int addnwstr(wchar_t *wstr, int n);

int waddwstr(WINDOW *win, wchar_t *wstr);

int waddnwstr(WINDOW *win, wchar_t *wstr, int n);

int mvaddwstr(int y, int x, wchar_t * wstr);

int mvaddnwstr(int y , int x, wchar_t * wstr, int n);

int mvwaddwstr(WINDOW *win, int y, int x, wchar_t *wstr);

int mvwaddnwstr(WINDOW *win, int y, int x , wchar_t *wstr, int n);

MT-Level

Unsafe

Description

All of these routines write all the characters of the null-terminated wchar_t character string wstr on the given window. The effect is similar to calling waddwch(3X) once for each wchar_t character in the string. The four routines with n as the last argument write at most n wchar_t characters. If n is negative, then the entire string will be added.

Return Value

All routines return the integer ERR upon failure and an integer value other than ERR upon successful completion.

See Also

curses(3X) , waddwch(3X)

Notes

The header file <curses.h> automatically includes the header files <stdio.h>, <unctrl.h> and <widec.h.

Note that all of these routines except waddwstr() and waddnwstr() may be macros.

Table of Contents