LWG2989 path's stream insertion operator lets you insert everything under the sun

Author: Dawn Perchik

source/iostreams.tex

@@ -10699,14 +10699,6 @@
 
   path operator/ (const path& lhs, const path& rhs);
 
-  // \ref{fs.path.io}, \tcode{path} inserter and extractor
-  template<class charT, class traits>
-    basic_ostream<charT, traits>&
-      operator<<(basic_ostream<charT, traits>& os, const path& p);
-  template<class charT, class traits>
-    basic_istream<charT, traits>&
-      operator>>(basic_istream<charT, traits>& is, path& p);
-
   // \ref{fs.path.factory}, \tcode{path} factory functions
   template<class Source>
     path u8path(const Source& source);
@@ -11156,6 +11148,14 @@
 
     iterator begin() const;
     iterator end() const;
+
+    // \ref{fs.path.io}, \tcode{path} inserter and extractor
+    template<class charT, class traits>
+      friend basic_ostream<charT, traits>&
+        operator<<(basic_ostream<charT, traits>& os, const path& p);
+    template<class charT, class traits>
+      friend basic_istream<charT, traits>&
+        operator>>(basic_istream<charT, traits>& is, path& p);
   };
 }
 \end{codeblock}
@@ -12581,6 +12581,45 @@
 \returns The end iterator.
 \end{itemdescr}
 
+\rSec3[fs.path.io]{\tcode{path} inserter and extractor}
+
+\indexlibrarymember{operator<<}{path}%
+\begin{itemdecl}
+template<class charT, class traits>
+  friend basic_ostream<charT, traits>&
+    operator<<(basic_ostream<charT, traits>& os, const path& p);
+\end{itemdecl}
+
+\begin{itemdescr}
+\pnum
+\effects Equivalent to \tcode{os << quoted(p.string<charT, traits>())}.
+\begin{note} The \tcode{quoted} function is described in~\ref{quoted.manip}. \end{note}
+
+\pnum
+\returns \tcode{os}.
+\end{itemdescr}
+
+\indexlibrarymember{operator>>}{path}%
+\begin{itemdecl}
+template<class charT, class traits>
+  friend basic_istream<charT, traits>&
+    operator>>(basic_istream<charT, traits>& is, path& p);
+\end{itemdecl}
+
+\begin{itemdescr}
+\pnum
+\effects
+Equivalent to:
+\begin{codeblock}
+basic_string<charT, traits> tmp;
+is >> quoted(tmp);
+p = tmp;
+\end{codeblock}
+
+\pnum
+\returns \tcode{is}.
+\end{itemdescr}
+
 \rSec3[fs.path.nonmember]{\tcode{path} non-member functions}
 
 \indexlibrary{\idxcode{swap}!\idxcode{path}}%
@@ -12691,45 +12730,6 @@
 \effects Equivalent to: \tcode{return path(lhs) /= rhs;}
 \end{itemdescr}
 
-\rSec4[fs.path.io]{\tcode{path} inserter and extractor}
-
-\indexlibrarymember{operator<<}{path}%
-\begin{itemdecl}
-template<class charT, class traits>
-  basic_ostream<charT, traits>&
-    operator<<(basic_ostream<charT, traits>& os, const path& p);
-\end{itemdecl}
-
-\begin{itemdescr}
-\pnum
-\effects Equivalent to \tcode{os << quoted(p.string<charT, traits>())}.
-\begin{note} The \tcode{quoted} function is described in~\ref{quoted.manip}. \end{note}
-
-\pnum
-\returns \tcode{os}.
-\end{itemdescr}
-
-\indexlibrarymember{operator>>}{path}%
-\begin{itemdecl}
-template<class charT, class traits>
-  basic_istream<charT, traits>&
-    operator>>(basic_istream<charT, traits>& is, path& p);
-\end{itemdecl}
-
-\begin{itemdescr}
-\pnum
-\effects
-Equivalent to:
-\begin{codeblock}
-basic_string<charT, traits> tmp;
-is >> quoted(tmp);
-p = tmp;
-\end{codeblock}
-
-\pnum
-\returns \tcode{is}.
-\end{itemdescr}
-
 \rSec4[fs.path.factory]{\tcode{path} factory functions}
 
 \indexlibrary{\idxcode{u8path}}%