X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcurs_printw.3x;h=9f804a45838be4829b5a31c04937b2ff14f47f32;hb=bb55d9e3947102ec2554482d47d21402093f32e8;hp=cd311fe60f729e2584b0aa0daa823c33483bb4ee;hpb=c0f109a299a82a33c16bd7af942a12ce9aefaaf0;p=ncurses.git diff --git a/man/curs_printw.3x b/man/curs_printw.3x index cd311fe6..9f804a45 100644 --- a/man/curs_printw.3x +++ b/man/curs_printw.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2019,2020 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_printw.3x,v 1.26 2020/03/14 23:48:47 tom Exp $ -.TH curs_printw 3X "" +.\" $Id: curs_printw.3x,v 1.38 2023/09/16 23:37:03 tom Exp $ +.TH curs_printw 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,47 +37,45 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBprintw\fR, -\fBwprintw\fR, -\fBmvprintw\fR, -\fBmvwprintw\fR, -\fBvwprintw\fR, \fBvw_printw\fR \- print formatted output in \fBcurses\fR windows -.ad -.hy +\fB\%printw\fP, +\fB\%wprintw\fP, +\fB\%mvprintw\fP, +\fB\%mvwprintw\fP, +\fB\%vwprintw\fP, +\fB\%vw_printw\fP \- +write formatted output to \fIcurses\fR windows .SH SYNOPSIS -\fB#include \fR +\fB#include \fP .sp -\fBint printw(const char *fmt, ...);\fR +\fBint printw(const char *\fIfmt\fB, ...);\fR .br -\fBint wprintw(WINDOW *win, const char *fmt, ...);\fR +\fBint wprintw(WINDOW *\fIwin\fB, const char *\fIfmt\fB, ...);\fR .br -\fBint mvprintw(int y, int x, const char *fmt, ...);\fR +\fBint mvprintw(int \fIy\fB, int \fIx\fB, const char *\fIfmt\fB, ...);\fR .br -\fBint mvwprintw(WINDOW *win, int y, int x, const char *fmt, ...);\fR +\fBint mvwprintw(WINDOW *\fIwin\fB, int \fIy\fB, int \fIx\fB, const char *\fIfmt\fB, ...);\fR .br -\fBint vw_printw(WINDOW *win, const char *fmt, va_list varglist);\fR +\fBint vw_printw(WINDOW *\fIwin\fB, const char *\fIfmt\fB, va_list \fIvarglist\fB);\fR .sp /* obsolete */ .br -\fBint vwprintw(WINDOW *win, const char *fmt, va_list varglist);\fR +\fBint vwprintw(WINDOW *\fIwin\fB, const char *\fIfmt\fB, va_list \fIvarglist\fB);\fR .SH DESCRIPTION -The \fBprintw\fR, \fBwprintw\fR, \fBmvprintw\fR and \fBmvwprintw\fR -routines are analogous to \fBprintf\fR [see \fBprintf\fR(3)]. +The \fBprintw\fP, \fBwprintw\fP, \fBmvprintw\fP and \fBmvwprintw\fP +routines are analogous to \fBprintf\fP [see \fBprintf\fP(3)]. In -effect, the string that would be output by \fBprintf\fR is output -instead as though \fBwaddstr\fR were used on the given window. +effect, the string that would be output by \fBprintf\fP is output +instead as though \fBwaddstr\fP were used on the given window. .PP -The \fBvwprintw\fR and \fBwv_printw\fR routines are analogous -to \fBvprintf\fR [see \fBprintf\fR(3)] -and perform a \fBwprintw\fR using a variable argument list. -The third argument is a \fBva_list\fR, a pointer to a -list of arguments, as defined in \fB\fR. +The \fBvwprintw\fP and \fBvw_printw\fP routines are analogous +to \fBvprintf\fP [see \fBprintf\fP(3)] +and perform a \fBwprintw\fP using a variable argument list. +The third argument is a \fBva_list\fP, a pointer to a +list of arguments, as defined in \fB\fP. .SH RETURN VALUE -Routines that return an integer return \fBERR\fR upon failure and \fBOK\fR -(SVr4 only specifies "an integer value other than \fBERR\fR") upon successful +Routines that return an integer return \fBERR\fP upon failure and \fBOK\fP +(SVr4 only specifies "an integer value other than \fBERR\fP") upon successful completion. .PP X/Open defines no error conditions. @@ -117,7 +115,7 @@ instead be output using \fBwaddstr\fP on the given window. SVr3 also added \fBvwprintw\fP, saying that the third parameter is a \fBva_list\fP, defined in , and referring the reader to the manual pages for \fIvarargs\fP and -\fIvprintf\fP for detailed descriptions. +\fBvprintf\fP for detailed descriptions. .PP SVr4 added no new variations of \fBprintw\fP, but provided for using or to define the \fBva_list\fP @@ -132,23 +130,23 @@ However, the latter (\fBvwprintw\fP) is obsolete: .bP The XSI Curses standard, Issue 4 described these functions. The function -\fBvwprintw\fR is marked TO BE WITHDRAWN, and is to be replaced by a function -\fBvw_printw\fR using the \fB\fR interface. +\fBvwprintw\fP is marked TO BE WITHDRAWN, and is to be replaced by a function +\fBvw_printw\fP using the \fB\fP interface. .bP The Single Unix Specification, Version 2 states that -\fBvw_printw\fR is preferred to \fBvwprintw\fR since the latter requires -including \fB\fR, which -cannot be used in the same file as \fB\fR. -This implementation uses \fB\fR for both, -because that header is included in \fB. +\fBvw_printw\fP is preferred to \fBvwprintw\fP since the latter requires +including \fB\fP, which +cannot be used in the same file as \fB\fP. +This implementation uses \fB\fP for both, +because that header is included in \fB. .bP X/Open Curses, Issue 5 (December 2007) marked \fBvwprintw\fP (along with \fBvwscanw\fP and the termcap interface) as withdrawn. .SH SEE ALSO .na -\fBcurses\fR(3X), -\fBcurs_addstr\fR(3X), -\fBcurs_scanw\fR(3X), +\fBcurses\fP(3X), +\fBcurs_addstr\fP(3X), +\fBcurs_scanw\fP(3X), \fBcurs_termcap\fP(3X), -\fBprintf\fR(3), -\fBvprintf\fR(3). +\fBprintf\fP(3), +\fBvprintf\fP(3).