Merge 2024-03 LWG Motion 7

P3142R0 Printing Blank Lines with println

Author: tkoeppe

source/iostreams.tex

@@ -4205,6 +4205,7 @@
     void print(ostream& os, format_string<Args...> fmt, Args&&... args);
   template<class... Args>
     void println(ostream& os, format_string<Args...> fmt, Args&&... args);
+  void println(ostream& os);
 
   void vprint_unicode(ostream& os, string_view fmt, format_args args);
   void vprint_nonunicode(ostream& os, string_view fmt, format_args args);
@@ -4257,8 +4258,10 @@
   // \ref{print.fun}, print functions
   template<class... Args>
     void print(format_string<Args...> fmt, Args&&... args);
+  void println();
   template<class... Args>
     void print(FILE* stream, format_string<Args...> fmt, Args&&... args);
+  void println(FILE* stream);
 
   template<class... Args>
     void println(format_string<Args...> fmt, Args&&... args);
@@ -6822,6 +6825,20 @@
 \end{codeblock}
 \end{itemdescr}
 
+\indexlibraryglobal{println}%
+\begin{itemdecl}
+void println(ostream& os);
+\end{itemdecl}
+
+\begin{itemdescr}
+\pnum
+\effects
+Equivalent to:
+\begin{codeblock}
+print(os, "\n");
+\end{codeblock}
+\end{itemdescr}
+
 \indexlibraryglobal{vprint_unicode}%
 \indexlibraryglobal{vprint_nonunicode}%
 \begin{itemdecl}
@@ -7737,6 +7754,20 @@
 \end{codeblock}
 \end{itemdescr}
 
+\indexlibraryglobal{println}%
+\begin{itemdecl}
+void println();
+\end{itemdecl}
+
+\begin{itemdescr}
+\pnum
+\effects
+Equivalent to:
+\begin{codeblock}
+println(stdout);
+\end{codeblock}
+\end{itemdescr}
+
 \indexlibraryglobal{println}%
 \begin{itemdecl}
 template<class... Args>
@@ -7752,6 +7783,20 @@
 \end{codeblock}
 \end{itemdescr}
 
+\indexlibraryglobal{println}%
+\begin{itemdecl}
+void println(FILE* stream);
+\end{itemdecl}
+
+\begin{itemdescr}
+\pnum
+\effects
+Equivalent to:
+\begin{codeblock}
+print(stream, "\n");
+\end{codeblock}
+\end{itemdescr}
+
 \indexlibraryglobal{vprint_unicode}%
 \begin{itemdecl}
 void vprint_unicode(string_view fmt, format_args args);