diff options
Diffstat (limited to 'doc/html/man/curs_printw.3x.html')
| -rw-r--r-- | doc/html/man/curs_printw.3x.html | 79 |
1 files changed, 39 insertions, 40 deletions
diff --git a/doc/html/man/curs_printw.3x.html b/doc/html/man/curs_printw.3x.html index 259b56121b93..c4a3743ff696 100644 --- a/doc/html/man/curs_printw.3x.html +++ b/doc/html/man/curs_printw.3x.html @@ -1,6 +1,6 @@ <!-- **************************************************************************** - * Copyright 2018-2023,2024 Thomas E. Dickey * + * Copyright 2018-2024,2025 Thomas E. Dickey * * Copyright 1998-2010,2017 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,25 +27,23 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_printw.3x,v 1.53 2024/04/20 19:18:18 tom Exp @ + * @Id: curs_printw.3x,v 1.65 2025/08/16 19:59:33 tom Exp @ --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML> <HEAD> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <meta name="generator" content="Manpage converted by man2html - see https://invisible-island.net/scripts/readme.html#others_scripts"> -<TITLE>curs_printw 3x 2024-04-20 ncurses 6.5 Library calls</TITLE> +<TITLE>curs_printw 3x 2025-08-16 ncurses 6.6 Library calls</TITLE> <link rel="author" href="mailto:bug-ncurses@gnu.org"> </HEAD> <BODY> -<H1 class="no-header">curs_printw 3x 2024-04-20 ncurses 6.5 Library calls</H1> +<H1 class="no-header">curs_printw 3x 2025-08-16 ncurses 6.6 Library calls</H1> <PRE> <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG> Library calls <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG> - - </PRE><H2><a name="h2-NAME">NAME</a></H2><PRE> <STRONG>printw</STRONG>, <STRONG>wprintw</STRONG>, <STRONG>mvprintw</STRONG>, <STRONG>mvwprintw</STRONG>, <STRONG>vwprintw</STRONG>, <STRONG>vw_printw</STRONG> - write formatted output to a <EM>curses</EM> window @@ -80,74 +78,75 @@ These functions return <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG> upon success. In <EM>ncurses</EM>, failure occurs if the library cannot allocate enough memory - for the buffer into which the output is formatted, or if the window + for the buffer into which the output is formatted, or if the window pointer <EM>win</EM> is null. - Functions prefixed with "mv" first perform cursor movement and fail if + Functions prefixed with "mv" first perform cursor movement and fail if the position (<EM>y</EM>, <EM>x</EM>) is outside the window boundaries. </PRE><H2><a name="h2-NOTES">NOTES</a></H2><PRE> - No wide character counterpart functions are defined by the "wide" + No wide character counterpart functions are defined by the "wide" <EM>ncurses</EM> configuration nor by any standard. To format and write a wide- character string to a <EM>curses</EM> window, consider using <STRONG>swprintf(3)</STRONG> and <STRONG><A HREF="curs_addwstr.3x.html">waddwstr(3x)</A></STRONG> or similar. </PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE> - X/Open Curses, Issue 4 describes these functions. It specifies no - error conditions for them. + X/Open Curses Issue 4 describes these functions. It specifies no error + conditions for them. - <EM>ncurses</EM> defines <STRONG>vw_printw</STRONG> and <STRONG>vwprintw</STRONG> identically to support legacy + <EM>ncurses</EM> defines <STRONG>vw_printw</STRONG> and <STRONG>vwprintw</STRONG> identically to support legacy applications. However, the latter is obsolete. - <STRONG>o</STRONG> X/Open Curses, Issue 4 Version 2 (1996), marked <STRONG>vwprintw</STRONG> as - requiring <EM>varargs.h</EM> and "TO BE WITHDRAWN", and specified <STRONG>vw_printw</STRONG> + <STRONG>o</STRONG> X/Open Curses Issue 4 Version 2 (1996), marked <STRONG>vwprintw</STRONG> as + requiring <EM>varargs.h</EM> and "TO BE WITHDRAWN", and specified <STRONG>vw_printw</STRONG> using the <EM>stdarg.h</EM> interface. - <STRONG>o</STRONG> X/Open Curses, Issue 5, Draft 2 (December 2007) marked <STRONG>vwprintw</STRONG> + <STRONG>o</STRONG> X/Open Curses Issue 5, Draft 2 (December 2007) marked <STRONG>vwprintw</STRONG> (along with <STRONG>vwscanw</STRONG> and the <EM>termcap</EM> interface) as withdrawn. After - incorporating review comments, this became X/Open Curses, Issue 7 + incorporating review comments, this became X/Open Curses Issue 7 (2009). <STRONG>o</STRONG> <EM>ncurses</EM> provides <STRONG>vwprintw</STRONG>, but marks it as deprecated. </PRE><H2><a name="h2-HISTORY">HISTORY</a></H2><PRE> - While <STRONG>printw</STRONG> was implemented in 4BSD (November 1980), it was unused - until 4.2BSD (August 1983), which employed it for games. That early - version of <EM>curses</EM> preceded the ANSI C standard of 1989. It did not use - <EM>varargs.h</EM>, though that had been available since Seventh Edition Unix - (1979). In 1991 (a couple of years after SVr4 was generally available, - and after the C standard was published), other developers updated the - library, using <EM>stdarg.h</EM> internally in 4.4BSD <EM>curses</EM>. Even with this - improvement, BSD <EM>curses</EM> did not use function prototypes (nor even - declare functions) in <EM>curses.h</EM> until 1992. - - SVr2 (1984) documented <STRONG>printw</STRONG> and <STRONG>wprintw</STRONG> tersely as "printf on <STRONG>stdscr</STRONG>" - and "printf on <EM>win</EM>", respectively. - - SVr3 (1987) added <STRONG>mvprintw</STRONG> and <STRONG>mvwprintw</STRONG>, with a three-line summary - asserting that they were analogous to <STRONG>printf(3)</STRONG>, explaining that the - string that <STRONG>printf(3)</STRONG> would write to the standard output stream would - instead be output using <STRONG>waddstr</STRONG> to the given window. SVr3 also - implemented <STRONG>vwprintw</STRONG>, describing its third parameter as a <EM>va</EM><STRONG>_</STRONG><EM>list</EM>, - defined in <EM>varargs.h</EM>, and referred the reader to the manual pages for + 4BSD (1980) introduced <EM>wprintw</EM> and its variants. It implemented all as + functions, not macros; this initial distribution of <EM>curses</EM> preceded the + ANSI C standard of 1989, prior to which a variadic macro facility was + not widely available in the language. <EM>printw</EM> went unused in Berkeley + distributions until 4.1cBSD (1983), which employed it in games. 4BSD's + <EM>wprintw</EM> did not use <EM>varargs.h</EM>, which had been available since Seventh + Edition Unix (1979). In 1991 (a couple of years after SVr4 was + generally available, and after the C standard was published), other + developers updated the library, using <EM>stdarg.h</EM> internally in 4.4BSD + <EM>curses</EM>. Even with this improvement, BSD <EM>curses</EM> did not use function + prototypes (nor even declare functions) in <EM>curses.h</EM> until 1992. + + 4BSD documented <EM>printw</EM> and <EM>wprintw</EM> tersely as "printf on <EM>stdscr</EM>" and + "printf on <EM>win</EM>", respectively. + + SVr3 summarized the functions in three lines, asserting that they were + analogous to <STRONG>printf(3)</STRONG> and explaining that the string that <STRONG>printf(3)</STRONG> + would write to the standard output stream would instead be output using + <EM>waddstr</EM> to the given window. + + SVr3 added <EM>vwprintw</EM>, describing its third parameter as a <EM>va</EM><STRONG>_</STRONG><EM>list</EM>, + defined in <EM>varargs.h</EM>, and referred the reader to the manual pages for <EM>varargs</EM> and <EM>vprintf</EM> for detailed descriptions. - SVr4 (1989) introduced no new variations of <EM>printw</EM>, but provided for + SVr4 (1989) introduced no new variations of <EM>printw</EM>, but provided for using either <EM>varargs.h</EM> or <EM>stdarg.h</EM> to define the <EM>va</EM><STRONG>_</STRONG><EM>list</EM> type. - X/Open Curses, Issue 4 (1995), defined <STRONG>vw_printw</STRONG> to replace <STRONG>vwprintw</STRONG>, + X/Open Curses Issue 4 (1995), defined <EM>vw</EM><STRONG>_</STRONG><EM>printw</EM> to replace <EM>vwprintw</EM>, stating that its <EM>va</EM><STRONG>_</STRONG><EM>list</EM> type is defined in <EM>stdarg.h</EM>. </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE> <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>, <STRONG><A HREF="curs_scanw.3x.html">curs_scanw(3x)</A></STRONG>, <STRONG>printf(3)</STRONG>, <STRONG>vprintf(3)</STRONG> - - -ncurses 6.5 2024-04-20 <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG> +ncurses 6.6 2025-08-16 <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG> </PRE> <div class="nav"> <ul> |