]> ncurses.scripts.mit.edu Git - ncurses.git/blobdiff - man/curs_addchstr.3x
ncurses 6.4 - patch 20231118
[ncurses.git] / man / curs_addchstr.3x
index ca285ada4151493c3844087517386705252e871f..5632f6e5663ec82866ea283e3c5815246b67c4f1 100644 (file)
@@ -27,8 +27,8 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: curs_addchstr.3x,v 1.34 2023/10/07 21:19:07 tom Exp $
-.TH curs_addchstr 3X 2023-10-07 "ncurses 6.4" "Library calls"
+.\" $Id: curs_addchstr.3x,v 1.36 2023/11/18 21:18:55 tom Exp $
+.TH curs_addchstr 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)
 \fIchstr\fP array
 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
@@ -97,7 +98,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,
@@ -108,8 +112,7 @@ All functions except \fBwaddchnstr\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_addstr\fP(3X)
-.PP
-Comparable functions in the wide-character (ncursesw) library are
-described in
-\fB\%curs_add_wchstr\fP(3X).
+\fB\%curs_addch\fP(3X),
+\fB\%curs_addstr\fP(3X),
+\fB\%curs_addwstr\fP(3X),
+\fB\%curs_add_wchstr\fP(3X)