X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcurs_addstr.3x;h=6820ce0c1357caca5fe22196e4c05677ce981fc4;hb=3183ac61c6bf0a75ee65dc8cbebf54f7c143df46;hp=88163422bd88bb7d141984bfe7f953b48b6e8664;hpb=f3ec084eb66ba14feb6357b674fb85dd474933d8;p=ncurses.git diff --git a/man/curs_addstr.3x b/man/curs_addstr.3x index 88163422..6820ce0c 100644 --- a/man/curs_addstr.3x +++ b/man/curs_addstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019,2020 Thomas E. Dickey * +.\" Copyright 2019-2021,2022 Thomas E. Dickey * .\" Copyright 1998-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addstr.3x,v 1.22 2020/03/22 00:06:42 tom Exp $ +.\" $Id: curs_addstr.3x,v 1.26 2022/02/12 20:07:29 tom Exp $ .TH curs_addstr 3X "" .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -40,51 +40,51 @@ .na .hy 0 .SH NAME -\fBaddstr\fR, -\fBaddnstr\fR, -\fBwaddstr\fR, -\fBwaddnstr\fR, -\fBmvaddstr\fR, -\fBmvaddnstr\fR, -\fBmvwaddstr\fR, -\fBmvwaddnstr\fR \- add a string of characters to a \fBcurses\fR window and advance cursor +\fBaddstr\fP, +\fBaddnstr\fP, +\fBwaddstr\fP, +\fBwaddnstr\fP, +\fBmvaddstr\fP, +\fBmvaddnstr\fP, +\fBmvwaddstr\fP, +\fBmvwaddnstr\fP \- add a string of characters to a \fBcurses\fP window and advance cursor .ad .hy .SH SYNOPSIS .nf -\fB#include \fR +\fB#include \fP .PP -\fBint addstr(const char *\fR\fIstr\fR\fB);\fR +\fBint addstr(const char *\fIstr\fB);\fR .br -\fBint addnstr(const char *\fR\fIstr\fR\fB, int \fR\fIn\fR\fB);\fR +\fBint addnstr(const char *\fIstr\fB, int \fIn\fB);\fR .br -\fBint waddstr(WINDOW *\fR\fIwin\fR\fB, const char *\fR\fIstr\fR\fB);\fR +\fBint waddstr(WINDOW *\fIwin\fB, const char *\fIstr\fB);\fR .br -\fBint waddnstr(WINDOW *\fR\fIwin\fR\fB, const char *\fR\fIstr\fR\fB, int \fR\fIn\fR\fB);\fR +\fBint waddnstr(WINDOW *\fIwin\fB, const char *\fIstr\fB, int \fIn\fB);\fR +.sp +\fBint mvaddstr(int \fIy\fB, int \fIx\fB, const char *\fIstr\fB);\fR .br -\fBint mvaddstr(int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const char *\fR\fIstr\fR\fB);\fR +\fBint mvaddnstr(int \fIy\fB, int \fIx\fB, const char *\fIstr\fB, int \fIn\fB);\fR .br -\fBint mvaddnstr(int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const char *\fR\fIstr\fR\fB, int \fR\fIn\fR\fB);\fR +\fBint mvwaddstr(WINDOW *\fIwin\fB, int \fIy\fB, int \fIx\fB, const char *\fIstr\fB);\fR .br -\fBint mvwaddstr(WINDOW *\fR\fIwin\fR\fB, int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const char *\fR\fIstr\fR\fB);\fR -.br -\fBint mvwaddnstr(WINDOW *\fR\fIwin\fR\fB, int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const char *\fR\fIstr, int \fR\fIn\fR\fB);\fR +\fBint mvwaddnstr(WINDOW *\fIwin\fB, int \fIy\fB, int \fIx\fB, const char *\fIstr, int \fIn\fB);\fR .fi .SH DESCRIPTION These functions write the (null-terminated) character string -\fIstr\fR on the given window. -It is similar to calling \fBwaddch\fR once for each byte in the string. +\fIstr\fP on the given window. +It is similar to calling \fBwaddch\fP once for each byte in the string. .PP -The \fImv\fR functions perform cursor movement once, before writing any +The \fImv\fP functions perform cursor movement once, before writing any characters. Thereafter, the cursor is advanced as a side-effect of writing to the window. .PP -The four functions with \fIn\fR as the last argument -write at most \fIn\fR bytes, +The four functions with \fIn\fP as the last argument +write at most \fIn\fP bytes, or until a terminating null is reached. -If \fIn\fR is \-1, then the entire string will be added. +If \fIn\fP is \-1, then the entire string will be added. .SH RETURN VALUE -All functions return the integer \fBERR\fR upon failure and \fBOK\fR on success. +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 @@ -111,9 +111,9 @@ there is a special case in \fBwaddch\fP where an error may be returned after successfully writing a character to the lower-right corner of a window when \fBscrollok\fP is disabled. .SH NOTES -All of these functions except \fBwaddnstr\fR may be macros. +All of these functions except \fBwaddnstr\fP may be macros. .SH PORTABILITY These functions are described in the XSI Curses standard, Issue 4. .SH SEE ALSO -\fBcurses\fR(3X), -\fBcurs_addch\fR(3X). +\fBcurses\fP(3X), +\fBcurs_addch\fP(3X).