X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_ins_wstr.3x.html;h=b964adbfd5012d6addee1975767c89bf141f8ad2;hp=3d8187041191bf9a1cd91bf51eb3e7e3ad18c334;hb=073e4446d2def7ebf1f0ff4f124f0c8d4af0b788;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/doc/html/man/curs_ins_wstr.3x.html b/doc/html/man/curs_ins_wstr.3x.html index 3d818704..b964adbf 100644 --- a/doc/html/man/curs_ins_wstr.3x.html +++ b/doc/html/man/curs_ins_wstr.3x.html @@ -1,7 +1,6 @@ - +
+ +- -curs_ins_wstr(3x) curs_ins_wstr(3x) +curs_ins_wstr(3x) curs_ins_wstr(3x) --
- ins_wstr, ins_nwstr, wins_wstr, wins_nwstr, mvins_wstr, - mvins_nwstr, mvwins_wstr, mvwins_nwstr - insert a wide- - character string into a curses window +
+ ins_wstr, ins_nwstr, wins_wstr, wins_nwstr, mvins_wstr, mvins_nwstr, + mvwins_wstr, mvwins_nwstr - insert a wide-character string into a + curses window --
+
#include <curses.h> int ins_wstr(const wchar_t *wstr); @@ -66,60 +64,59 @@ int mvwins_nwstr(WINDOW *win, int y, int x, const wchar_t *wstr, int n); --
- These routines insert a wchar_t character string (as many - characters as will fit on the line) before the character - under the cursor. All characters to the right of the cur- - sor are shifted right, with the possibility of the right- - most characters on the line being lost. No wrapping is - performed. The cursor position does not change (after - moving to y, x, if specified). The four routines with n - as the last argument insert a leading substring of at most - n wchar_t characters. If n is less than 1, the entire - string is inserted. - - If a character in wstr is a tab, newline, carriage return - or backspace, the cursor is moved appropriately within the - window. A newline also does a clrtoeol before moving. - Tabs are considered to be at every eighth column. If a - character in wstr is another control character, it is - drawn in the ^X notation. Calling win_wch after adding a - control character (and moving to it, if necessary) does - not return the control character, but instead returns a - character in the ^-representation of the control charac- - ter. +
+ These routines insert a wchar_t character string (as many characters as + will fit on the line) before the character under the cursor. All char- + acters to the right of the cursor are shifted right, with the possibil- + ity of the rightmost characters on the line being lost. No wrapping is + performed. The cursor position does not change (after moving to y, x, + if specified). The four routines with n as the last argument insert a + leading substring of at most n wchar_t characters. If n is less than + 1, the entire string is inserted. + If a character in wstr is a tab, newline, carriage return or backspace, + the cursor is moved appropriately within the window. A newline also + does a clrtoeol before moving. Tabs are considered to be at every + eighth column. If a character in wstr is another control character, it + is drawn in the ^X notation. Calling win_wch after adding a control + character (and moving to it, if necessary) does not return the control + character, but instead returns a character in the ^-representation of + the control character. --
+ +
Note that all but wins_nwstr may be macros. - If the first character in the string is a nonspacing char- - acter, these functions will fail. XSI does not define - what will happen if a nonspacing character follows a con- - trol character. + If the first character in the string is a nonspacing character, these + functions will fail. XSI does not define what will happen if a non- + spacing character follows a control character. --
- Upon successful completion, these functions return OK. - Otherwise, they return ERR. +
+ Upon successful completion, these functions return OK. Otherwise, they + return ERR. + Functions with a "mv" prefix first perform a cursor movement using + wmove, and return an error if the position is outside the window, or if + the window pointer is null. --
- curses(3x), curs_insstr(3x), curs_in_wch(3x), - curs_ins_wch(3x). + +
+ curses(3x), curs_insstr(3x), curs_in_wch(3x), curs_ins_wch(3x). - curs_ins_wstr(3x) + curs_ins_wstr(3x)-