HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

491

492

493

494

495

496

497

498

499

500

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

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.