X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcurs_add_wchstr.3x;h=c0fab61eaa5e7c24b726a6e62ae9a45762c823ae;hb=e2c422e26543d96636d8bde422550ea9c7005e9c;hp=3c2dbedfffc8343e5a6991e07b174bf9033e9116;hpb=122d3739b3c11c83decc625d53f26fff6e825710;p=ncurses.git diff --git a/man/curs_add_wchstr.3x b/man/curs_add_wchstr.3x index 3c2dbedf..c0fab61e 100644 --- a/man/curs_add_wchstr.3x +++ b/man/curs_add_wchstr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_add_wchstr.3x,v 1.28 2023/10/07 21:19:07 tom Exp $ -.TH curs_add_wchstr 3X 2023-10-07 "ncurses 6.4" "Library calls" +.\" $Id: curs_add_wchstr.3x,v 1.30 2023/11/18 21:18:55 tom Exp $ +.TH curs_add_wchstr 3X 2023-11-18 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -73,6 +73,7 @@ These functions copy the (null-terminated) array of complex characters \fIwchstr\fP into the window image structure starting at the current cursor position. +.PP The four functions with \fIn\fP as the last argument copy at most \fIn\fP elements, but no more than will fit on the line. @@ -80,7 +81,7 @@ If \fBn\fP=\fB\-1\fP then the whole array is copied, to the maximum number of characters that will fit on the line. .PP The window cursor is \fInot\fP advanced. -These functions work faster than \fBwaddnstr\fP. +These functions are faster than \fBwaddnstr\fP. On the other hand: .bP they do not perform checking @@ -103,7 +104,10 @@ All functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. .PP X/Open does not define any error conditions. This implementation returns an error -if the window pointer is null. +.bP +if the \fIwin\fP parameter is null or +.bP +if the \fIwchstr\fP parameter is null. .PP Functions with a \*(``mv\*('' prefix first perform a cursor movement using \fBwmove\fP, and return an error if the position is outside the window, @@ -114,8 +118,8 @@ All functions except \fBwadd_wchnstr\fP may be macros. These entry points are described in the XSI Curses standard, Issue 4. .SH SEE ALSO \fB\%curses\fP(3X), -\fB\%curs_addwstr\fP(3X) -.PP -Comparable functions in the narrow-character (ncurses) library are -described in -\fB\%curs_addchstr\fP(3X). +\fB\%curs_addch\fP(3X), +\fB\%curs_addchstr\fP(3X), +\fB\%curs_addstr\fP(3X), +\fB\%curs_addwstr\fP(3X), +\fB\%curs_add_wch\fP(3X)