45 lines
1.4 KiB
Groff
45 lines
1.4 KiB
Groff
|
.TH curs_addstr 3X ""
|
||
|
|
.SH NAME
|
||
|
|
\fBcurs_addstr\fR: \fBaddstr\fR, \fBaddnstr\fR, \fBwaddstr\fR, \fBwaddnstr\fR,
|
||
|
|
\fBmvaddstr\fR, \fBmvaddnstr\fR, \fBmvwaddstr\fR, \fBmvwaddnstr\fR - add a
|
||
|
|
string of characters to a \fBncurses\fR window and advance cursor
|
||
|
|
.SH SYNOPSIS
|
||
|
|
\fB#include <ncurses.h>\fR
|
||
|
|
|
||
|
|
\fBint addstr(char *str);\fR
|
||
|
|
.br
|
||
|
|
\fBint addnstr(char *str, int n);\fR
|
||
|
|
.br
|
||
|
|
\fBint waddstr(WINDOW *win, char *str);\fR
|
||
|
|
.br
|
||
|
|
\fBint waddnstr(WINDOW *win, char *str, int n);\fR
|
||
|
|
.br
|
||
|
|
\fBint mvaddstr(y, int x, char *str);\fR
|
||
|
|
.br
|
||
|
|
\fBint mvaddnstr(y, int x, char *str, int n);\fR
|
||
|
|
.br
|
||
|
|
\fBint mvwaddstr(WINDOW *win, int y, int x, char *str);\fR
|
||
|
|
.br
|
||
|
|
\fBint mvwaddnstr(WINDOW *win, int y, int x, char *str,
|
||
|
|
int n);\fR
|
||
|
|
.SH DESCRIPTION
|
||
|
|
These routines write the characters of the null terminated character string
|
||
|
|
\fIstr\fR on the given window. It is similar to calling \fBwaddch\fR once for
|
||
|
|
each character in the string. The four routines with \fIn\fR as the last
|
||
|
|
argument write at most \fIn\fR characters. If \fIn\fR is negative, then the
|
||
|
|
entire string will be added.
|
||
|
|
.SH RETURN VALUE
|
||
|
|
All routines return the integer \fBERR\fR upon failure and an integer value
|
||
|
|
other than \fBERR\fR upon successful completion.
|
||
|
|
.SH NOTES
|
||
|
|
Note that all of these routines except \fBwaddstr\fR and \fBwaddnstr\fR may be
|
||
|
|
macros.
|
||
|
|
.SH SEE ALSO
|
||
|
|
\fBncurses\fR(3X), \fBcurs_addch\fR(3X).
|
||
|
|
.\"#
|
||
|
|
.\"# The following sets edit modes for GNU EMACS
|
||
|
|
.\"# Local Variables:
|
||
|
|
.\"# mode:nroff
|
||
|
|
.\"# fill-column:79
|
||
|
|
.\"# End:
|