[file.streams] - C++11 → C++14

Files changed (1) hide show

tmp/tmpgj5t7r3z/{from.md → to.md} +40 -35

tmp/tmpgj5t7r3z/{from.md → to.md} RENAMED Viewed

@@ -215,11 +215,11 @@ basic_filebuf<charT,traits>* open(const char* s,
 *Effects:* If `is_open() != false`, returns a null pointer. Otherwise,
 initializes the `filebuf` as required. It then opens a file, if
 possible, whose name is the NTBS`s` (as if by calling
 `std::fopen(s,modstr)`). The NTBS`modstr` is determined from
-`mode & `~`ios_base::ate` as indicated in
 Table  [[tab:iostreams.file.open.modes]]. If `mode` is not some
 combination of flags shown in the table then the open fails.
 **Table: File open modes** <a id="tab:iostreams.file.open.modes">[tab:iostreams.file.open.modes]</a>
@@ -244,11 +244,11 @@ combination of flags shown in the table then the open fails.
 | +        | +    |       |         | +     | `"a+b"` |
 If the open operation succeeds and `(mode & ios_base::ate) != 0`,
 positions the file to the end (as if by calling
-`std::fseek(file,0,SEEK_END)`).[^38]
 If the repositioning operation fails, calls `close()` and returns a null
 pointer to indicate failure.
 *Returns:* `this` if successful, a null pointer otherwise.
@@ -270,11 +270,11 @@ last virtual member function called on `*this` (between `underflow`,
 `overflow`, `seekoff`, and `seekpos`) was `overflow` then calls
 `a_codecvt.unshift` (possibly several times) to determine a termination
 sequence, inserts those characters and calls `overflow(traits::eof())`
 again. Finally, regardless of whether any of the preceding calls fails
 or throws an exception, the function closes the file (as if by calling
-`std::fclose(file)`).[^39] If any of the calls made by the function,
 including `std::fclose`, fails, `close` fails by returning a null
 pointer. If one of these calls throws an exception, the exception is
 caught and rethrown after closing the file.
 *Returns:* `this` on success, a null pointer otherwise.
@@ -520,11 +520,11 @@ namespace std {
     bool is_open() const;
     void open(const char* s, ios_base::openmode mode = ios_base::in);
     void open(const string& s, ios_base::openmode mode = ios_base::in);
     void close();
   private:
-    basic_filebuf<charT,traits> sb; // exposition onlyr
   };
   template <class charT, class traits>
   void swap(basic_ifstream<charT, traits>& x,
             basic_ifstream<charT, traits>& y);
@@ -672,11 +672,11 @@ namespace std {
     bool is_open() const;
     void open(const char* s, ios_base::openmode mode = ios_base::out);
     void open(const string& s, ios_base::openmode mode = ios_base::out);
     void close();
   private:
-    basic_filebuf<charT,traits> sb; // exposition onlyr
   };
   template <class charT, class traits>
   void swap(basic_ofstream<charT, traits>& x,
             basic_ofstream<charT, traits>& y);
@@ -828,11 +828,11 @@ namespace std {
     void open(const string& s,
         ios_base::openmode mode = ios_base::in|ios_base::out);
     void close();
   private:
-    basic_filebuf<charT,traits> sb; // exposition onlyr
   };
   template <class charT, class traits>
   void swap(basic_fstream<charT, traits>& x,
             basic_fstream<charT, traits>& y);
@@ -948,11 +948,12 @@ void close();
 returns a null pointer, calls `setstate(failbit)` ([[iostate.flags]])
 (which may throw `ios_base::failure`).
 ### C library files <a id="c.files">[[c.files]]</a>
-Table  [[tab:iostreams.hdr.cstdio]] describes header `<cstdio>`.
 Calls to the function `tmpnam` with an argument of `NULL` may introduce
 a data race ([[res.on.data.races]]) with other calls to `tmpnam` with
 an argument of `NULL`.
@@ -989,11 +990,10 @@ Library header `<inttypes.h>`, with the following changes:
 [bitmask.types]: library.md#bitmask.types
 [c.files]: #c.files
 [enumerated.types]: library.md#enumerated.types
 [error.reporting]: #error.reporting
 [ext.manip]: #ext.manip
-[facet.num.put.virtuals]: localization.md#facet.num.put.virtuals
 [fig:streampos]: #fig:streampos
 [file.streams]: #file.streams
 [filebuf]: #filebuf
 [filebuf.assign]: #filebuf.assign
 [filebuf.cons]: #filebuf.cons
@@ -1088,10 +1088,11 @@ Library header `<inttypes.h>`, with the following changes:
 [ostringstream]: #ostringstream
 [ostringstream.assign]: #ostringstream.assign
 [ostringstream.cons]: #ostringstream.cons
 [ostringstream.members]: #ostringstream.members
 [output.streams]: #output.streams
 [res.on.data.races]: library.md#res.on.data.races
 [res.on.exception.handling]: library.md#res.on.exception.handling
 [std.ios.manip]: #std.ios.manip
 [std.manip]: #std.manip
 [stream.buffers]: #stream.buffers
@@ -1201,81 +1202,85 @@ Library header `<inttypes.h>`, with the following changes:
 [^15]: Classes derived from `basic_streambuf` can provide more efficient
     ways to implement `xsgetn()` and `xsputn()` by overriding these
     definitions from the base class.
-[^16]: This will be possible only in functions that are part of the
     library. The semantics of the constructor used in user code is as
     specified.
-[^17]: The sentry constructor and destructor can also perform additional
     implementation-dependent operations.
-[^18]: This is done without causing an `ios::failure` to be thrown.
-[^19]: See, for example, the function signature
-    `ws(basic_istream&)` ([[istream.manip]]).
 [^20]: See, for example, the function signature
     `dec(ios_base&)` ([[basefield.manip]]).
-[^21]: This is done without causing an `ios::failure` to be thrown.
-[^22]: Note that this function is not overloaded on types `signed char`
-    and `unsigned char`.
 [^23]: Note that this function is not overloaded on types `signed char`
     and `unsigned char`.
 [^24]: Note that this function is not overloaded on types `signed char`
     and `unsigned char`.
-[^25]: Since the final input character is “extracted,” it is counted in
     the `gcount()`, even though it is not stored.
-[^26]: This allows an input line which exactly fills the buffer, without
     setting `failbit`. This is different behavior than the historical
     AT&T implementation.
-[^27]: This implies an empty input line will not cause `failbit` to be
     set.
-[^28]: Note that this function is not overloaded on types `signed char`
     and `unsigned char`.
-[^29]: The call `os.tie()->flush()` does not necessarily occur if the
     function can determine that no synchronization is necessary.
-[^30]: The `sentry` constructor and destructor can also perform
     additional implementation-dependent operations.
-[^31]: without causing an `ios::failure` to be thrown.
-[^32]: See, for example, the function signature
-    `endl(basic_ostream&)` ([[ostream.manip]]).
 [^33]: See, for example, the function signature
     `dec(ios_base&)` ([[basefield.manip]]).
-[^34]: without causing an `ios::failure` to be thrown.
-[^35]: Note that this function is not overloaded on types `signed char`
-    and `unsigned char`.
 [^36]: Note that this function is not overloaded on types `signed char`
     and `unsigned char`.
-[^37]: The expression `cin >>resetiosflags(ios_base::skipws)` clears
     `ios_base::skipws` in the format flags stored in the
     `basic_istream<charT,traits>` object `cin` (the same as
     `cin >>noskipws`), and the expression
     `cout << resetiosflags(ios_base::showbase)` clears
     `ios_base::showbase` in the format flags stored in the
     `basic_ostream<charT,traits>` object `cout` (the same as
     `cout <<noshowbase`).
-[^38]: The macro `SEEK_END` is defined, and the function signatures
     `fopen(const char*, const char*)` and `fseek(FILE*, long, int)` are
     declared, in `<cstdio>` ([[c.files]]).
-[^39]: The function signature `fclose(FILE*)` is declared in `<cstdio>`
     ([[c.files]]).

 *Effects:* If `is_open() != false`, returns a null pointer. Otherwise,
 initializes the `filebuf` as required. It then opens a file, if
 possible, whose name is the NTBS`s` (as if by calling
 `std::fopen(s,modstr)`). The NTBS`modstr` is determined from
+`mode & ~ios_base::ate` as indicated in
 Table  [[tab:iostreams.file.open.modes]]. If `mode` is not some
 combination of flags shown in the table then the open fails.
 **Table: File open modes** <a id="tab:iostreams.file.open.modes">[tab:iostreams.file.open.modes]</a>
 | +        | +    |       |         | +     | `"a+b"` |
 If the open operation succeeds and `(mode & ios_base::ate) != 0`,
 positions the file to the end (as if by calling
+`std::fseek(file,0,SEEK_END)`).[^39]
 If the repositioning operation fails, calls `close()` and returns a null
 pointer to indicate failure.
 *Returns:* `this` if successful, a null pointer otherwise.
 `overflow`, `seekoff`, and `seekpos`) was `overflow` then calls
 `a_codecvt.unshift` (possibly several times) to determine a termination
 sequence, inserts those characters and calls `overflow(traits::eof())`
 again. Finally, regardless of whether any of the preceding calls fails
 or throws an exception, the function closes the file (as if by calling
+`std::fclose(file)`).[^40] If any of the calls made by the function,
 including `std::fclose`, fails, `close` fails by returning a null
 pointer. If one of these calls throws an exception, the exception is
 caught and rethrown after closing the file.
 *Returns:* `this` on success, a null pointer otherwise.
     bool is_open() const;
     void open(const char* s, ios_base::openmode mode = ios_base::in);
     void open(const string& s, ios_base::openmode mode = ios_base::in);
     void close();
   private:
+    basic_filebuf<charT,traits> sb; // exposition only
   };
   template <class charT, class traits>
   void swap(basic_ifstream<charT, traits>& x,
             basic_ifstream<charT, traits>& y);
     bool is_open() const;
     void open(const char* s, ios_base::openmode mode = ios_base::out);
     void open(const string& s, ios_base::openmode mode = ios_base::out);
     void close();
   private:
+    basic_filebuf<charT,traits> sb; // exposition only
   };
   template <class charT, class traits>
   void swap(basic_ofstream<charT, traits>& x,
             basic_ofstream<charT, traits>& y);
     void open(const string& s,
         ios_base::openmode mode = ios_base::in|ios_base::out);
     void close();
   private:
+    basic_filebuf<charT,traits> sb; // exposition only
   };
   template <class charT, class traits>
   void swap(basic_fstream<charT, traits>& x,
             basic_fstream<charT, traits>& y);
 returns a null pointer, calls `setstate(failbit)` ([[iostate.flags]])
 (which may throw `ios_base::failure`).
 ### C library files <a id="c.files">[[c.files]]</a>
+Table  [[tab:iostreams.hdr.cstdio]] describes header `<cstdio>`. C++does
+not define the function `gets`.
 Calls to the function `tmpnam` with an argument of `NULL` may introduce
 a data race ([[res.on.data.races]]) with other calls to `tmpnam` with
 an argument of `NULL`.
 [bitmask.types]: library.md#bitmask.types
 [c.files]: #c.files
 [enumerated.types]: library.md#enumerated.types
 [error.reporting]: #error.reporting
 [ext.manip]: #ext.manip
 [fig:streampos]: #fig:streampos
 [file.streams]: #file.streams
 [filebuf]: #filebuf
 [filebuf.assign]: #filebuf.assign
 [filebuf.cons]: #filebuf.cons
 [ostringstream]: #ostringstream
 [ostringstream.assign]: #ostringstream.assign
 [ostringstream.cons]: #ostringstream.cons
 [ostringstream.members]: #ostringstream.members
 [output.streams]: #output.streams
+[quoted.manip]: #quoted.manip
 [res.on.data.races]: library.md#res.on.data.races
 [res.on.exception.handling]: library.md#res.on.exception.handling
 [std.ios.manip]: #std.ios.manip
 [std.manip]: #std.manip
 [stream.buffers]: #stream.buffers
 [^15]: Classes derived from `basic_streambuf` can provide more efficient
     ways to implement `xsgetn()` and `xsputn()` by overriding these
     definitions from the base class.
+[^16]: Typically, `overflow` returns `c` to indicate success, except
+    when `traits::eq_int_type(c,traits::eof())` returns `true`, in which
+    case it returns `traits::not_eof(c)`.
+[^17]: This will be possible only in functions that are part of the
     library. The semantics of the constructor used in user code is as
     specified.
+[^18]: The sentry constructor and destructor can also perform additional
     implementation-dependent operations.
+[^19]: This is done without causing an `ios::failure` to be thrown.
 [^20]: See, for example, the function signature
+    `ws(basic_istream&)` ([[istream.manip]]).
+[^21]: See, for example, the function signature
     `dec(ios_base&)` ([[basefield.manip]]).
+[^22]: This is done without causing an `ios::failure` to be thrown.
 [^23]: Note that this function is not overloaded on types `signed char`
     and `unsigned char`.
 [^24]: Note that this function is not overloaded on types `signed char`
     and `unsigned char`.
+[^25]: Note that this function is not overloaded on types `signed char`
+    and `unsigned char`.
+[^26]: Since the final input character is “extracted,” it is counted in
     the `gcount()`, even though it is not stored.
+[^27]: This allows an input line which exactly fills the buffer, without
     setting `failbit`. This is different behavior than the historical
     AT&T implementation.
+[^28]: This implies an empty input line will not cause `failbit` to be
     set.
+[^29]: Note that this function is not overloaded on types `signed char`
     and `unsigned char`.
+[^30]: The call `os.tie()->flush()` does not necessarily occur if the
     function can determine that no synchronization is necessary.
+[^31]: The `sentry` constructor and destructor can also perform
     additional implementation-dependent operations.
+[^32]: without causing an `ios::failure` to be thrown.
 [^33]: See, for example, the function signature
+    `endl(basic_ostream&)` ([[ostream.manip]]).
+[^34]: See, for example, the function signature
     `dec(ios_base&)` ([[basefield.manip]]).
+[^35]: without causing an `ios::failure` to be thrown.
 [^36]: Note that this function is not overloaded on types `signed char`
     and `unsigned char`.
+[^37]: Note that this function is not overloaded on types `signed char`
+    and `unsigned char`.
+[^38]: The expression `cin >>resetiosflags(ios_base::skipws)` clears
     `ios_base::skipws` in the format flags stored in the
     `basic_istream<charT,traits>` object `cin` (the same as
     `cin >>noskipws`), and the expression
     `cout << resetiosflags(ios_base::showbase)` clears
     `ios_base::showbase` in the format flags stored in the
     `basic_ostream<charT,traits>` object `cout` (the same as
     `cout <<noshowbase`).
+[^39]: The macro `SEEK_END` is defined, and the function signatures
     `fopen(const char*, const char*)` and `fseek(FILE*, long, int)` are
     declared, in `<cstdio>` ([[c.files]]).
+[^40]: The function signature `fclose(FILE*)` is declared in `<cstdio>`
     ([[c.files]]).

Diff to HTML by rtfpessoa