The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group


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


#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);


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.


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


No errors are defined.



UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]