ENHANCED CURSES

NAME

ins_nwstr, ins_wstr, mvins_nwstr, mvins_wstr, mvwins_nwstr, mvwins_wstr, wins_nwstr, wins_wstr — insert a wide-character string into a window

SYNOPSIS

#include <curses.h>

int ins_nwstr(wchar_t *const wstr, int n);

int ins_wstr(wchar_t *const wstr);

int mvins_nwstr(int y, int x, wchar_t *const wstr, int n);

int mvins_wstr(int y, int x, wchar_t *const wstr);

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

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

int wins_nwstr(WINDOW *win, wchar_t *const wstr, int n);

int wins_wstr(WINDOW *win, wchar_t *const wstr);

DESCRIPTION

These functions insert a wchar_t character string (as many wchar_t characters as will fit on the line) in the current or specified window immediately before the current or specified position. 

Any non-spacing characters in the string are associated with the first spacing character in the string that precedes the non-spacing characters.  If the first character in the string is a non-spacing character, these functions will fail. 

These functions do not perform wrapping.  These functions do not advance the cursor position.  These functions perform special-character processing. 

The ins_nwstr(), mvins_nwstr(), mvwins_nwstr() and wins_nwstr() functions insert at most n wchar_t characters.  If n is less than 1, then the entire string is inserted. 

RETURN VALUE

Upon successful completion, these functions return OK.  Otherwise, they return ERR. 

ERRORS

No errors are defined. 

SEE ALSO

<curses.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 4. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996