HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

ins_nwstr(3X) ins_nwstr(3X)

(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(const wchar_t *wstr, int n);

int ins_wstr(const wchar_t *wstr);

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

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

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

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

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

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

DESCRIPTION

These functions insert a wchar_t character string (as many wchar_t characters as will ﬁt on the line) in

the current or speciﬁed window immediately before the current or speciﬁed position.

Any non-spacing characters in the string are associated with the ﬁrst spacing character in the string that

precedes the non-spacing characters. If the ﬁrst 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 func-

tions 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 deﬁned.