From Jason Turner

[c.files]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpru9fyzwv/{from.md → to.md} +34 -29
tmp/tmpru9fyzwv/{from.md → to.md} RENAMED
@@ -1,8 +1,9 @@
1
  ### C library files <a id="c.files">[[c.files]]</a>
2
 
3
- Table  [[tab:iostreams.hdr.cstdio]] describes header `<cstdio>`.
 
4
 
5
  Calls to the function `tmpnam` with an argument of `NULL` may introduce
6
  a data race ([[res.on.data.races]]) with other calls to `tmpnam` with
7
  an argument of `NULL`.
8
 
@@ -39,11 +40,10 @@ Library header `<inttypes.h>`, with the following changes:
39
  [bitmask.types]: library.md#bitmask.types
40
  [c.files]: #c.files
41
  [enumerated.types]: library.md#enumerated.types
42
  [error.reporting]: #error.reporting
43
  [ext.manip]: #ext.manip
44
- [facet.num.put.virtuals]: localization.md#facet.num.put.virtuals
45
  [fig:streampos]: #fig:streampos
46
  [file.streams]: #file.streams
47
  [filebuf]: #filebuf
48
  [filebuf.assign]: #filebuf.assign
49
  [filebuf.cons]: #filebuf.cons
@@ -138,10 +138,11 @@ Library header `<inttypes.h>`, with the following changes:
138
  [ostringstream]: #ostringstream
139
  [ostringstream.assign]: #ostringstream.assign
140
  [ostringstream.cons]: #ostringstream.cons
141
  [ostringstream.members]: #ostringstream.members
142
  [output.streams]: #output.streams
 
143
  [res.on.data.races]: library.md#res.on.data.races
144
  [res.on.exception.handling]: library.md#res.on.exception.handling
145
  [std.ios.manip]: #std.ios.manip
146
  [std.manip]: #std.manip
147
  [stream.buffers]: #stream.buffers
@@ -251,81 +252,85 @@ Library header `<inttypes.h>`, with the following changes:
251
 
252
  [^15]: Classes derived from `basic_streambuf` can provide more efficient
253
  ways to implement `xsgetn()` and `xsputn()` by overriding these
254
  definitions from the base class.
255
 
256
- [^16]: This will be possible only in functions that are part of the
 
 
 
 
257
  library. The semantics of the constructor used in user code is as
258
  specified.
259
 
260
- [^17]: The sentry constructor and destructor can also perform additional
261
  implementation-dependent operations.
262
 
263
- [^18]: This is done without causing an `ios::failure` to be thrown.
264
-
265
- [^19]: See, for example, the function signature
266
- `ws(basic_istream&)` ([[istream.manip]]).
267
 
268
  [^20]: See, for example, the function signature
 
 
 
269
  `dec(ios_base&)` ([[basefield.manip]]).
270
 
271
- [^21]: This is done without causing an `ios::failure` to be thrown.
272
-
273
- [^22]: Note that this function is not overloaded on types `signed char`
274
- and `unsigned char`.
275
 
276
  [^23]: Note that this function is not overloaded on types `signed char`
277
  and `unsigned char`.
278
 
279
  [^24]: Note that this function is not overloaded on types `signed char`
280
  and `unsigned char`.
281
 
282
- [^25]: Since the final input character is “extracted,” it is counted in
 
 
 
283
  the `gcount()`, even though it is not stored.
284
 
285
- [^26]: This allows an input line which exactly fills the buffer, without
286
  setting `failbit`. This is different behavior than the historical
287
  AT&T implementation.
288
 
289
- [^27]: This implies an empty input line will not cause `failbit` to be
290
  set.
291
 
292
- [^28]: Note that this function is not overloaded on types `signed char`
293
  and `unsigned char`.
294
 
295
- [^29]: The call `os.tie()->flush()` does not necessarily occur if the
296
  function can determine that no synchronization is necessary.
297
 
298
- [^30]: The `sentry` constructor and destructor can also perform
299
  additional implementation-dependent operations.
300
 
301
- [^31]: without causing an `ios::failure` to be thrown.
302
-
303
- [^32]: See, for example, the function signature
304
- `endl(basic_ostream&)` ([[ostream.manip]]).
305
 
306
  [^33]: See, for example, the function signature
 
 
 
307
  `dec(ios_base&)` ([[basefield.manip]]).
308
 
309
- [^34]: without causing an `ios::failure` to be thrown.
310
-
311
- [^35]: Note that this function is not overloaded on types `signed char`
312
- and `unsigned char`.
313
 
314
  [^36]: Note that this function is not overloaded on types `signed char`
315
  and `unsigned char`.
316
 
317
- [^37]: The expression `cin >>resetiosflags(ios_base::skipws)` clears
 
 
 
318
  `ios_base::skipws` in the format flags stored in the
319
  `basic_istream<charT,traits>` object `cin` (the same as
320
  `cin >>noskipws`), and the expression
321
  `cout << resetiosflags(ios_base::showbase)` clears
322
  `ios_base::showbase` in the format flags stored in the
323
  `basic_ostream<charT,traits>` object `cout` (the same as
324
  `cout <<noshowbase`).
325
 
326
- [^38]: The macro `SEEK_END` is defined, and the function signatures
327
  `fopen(const char*, const char*)` and `fseek(FILE*, long, int)` are
328
  declared, in `<cstdio>` ([[c.files]]).
329
 
330
- [^39]: The function signature `fclose(FILE*)` is declared in `<cstdio>`
331
  ([[c.files]]).
 
1
  ### C library files <a id="c.files">[[c.files]]</a>
2
 
3
+ Table  [[tab:iostreams.hdr.cstdio]] describes header `<cstdio>`. C++does
4
+ not define the function `gets`.
5
 
6
  Calls to the function `tmpnam` with an argument of `NULL` may introduce
7
  a data race ([[res.on.data.races]]) with other calls to `tmpnam` with
8
  an argument of `NULL`.
9
 
 
40
  [bitmask.types]: library.md#bitmask.types
41
  [c.files]: #c.files
42
  [enumerated.types]: library.md#enumerated.types
43
  [error.reporting]: #error.reporting
44
  [ext.manip]: #ext.manip
 
45
  [fig:streampos]: #fig:streampos
46
  [file.streams]: #file.streams
47
  [filebuf]: #filebuf
48
  [filebuf.assign]: #filebuf.assign
49
  [filebuf.cons]: #filebuf.cons
 
138
  [ostringstream]: #ostringstream
139
  [ostringstream.assign]: #ostringstream.assign
140
  [ostringstream.cons]: #ostringstream.cons
141
  [ostringstream.members]: #ostringstream.members
142
  [output.streams]: #output.streams
143
+ [quoted.manip]: #quoted.manip
144
  [res.on.data.races]: library.md#res.on.data.races
145
  [res.on.exception.handling]: library.md#res.on.exception.handling
146
  [std.ios.manip]: #std.ios.manip
147
  [std.manip]: #std.manip
148
  [stream.buffers]: #stream.buffers
 
252
 
253
  [^15]: Classes derived from `basic_streambuf` can provide more efficient
254
  ways to implement `xsgetn()` and `xsputn()` by overriding these
255
  definitions from the base class.
256
 
257
+ [^16]: Typically, `overflow` returns `c` to indicate success, except
258
+ when `traits::eq_int_type(c,traits::eof())` returns `true`, in which
259
+ case it returns `traits::not_eof(c)`.
260
+
261
+ [^17]: This will be possible only in functions that are part of the
262
  library. The semantics of the constructor used in user code is as
263
  specified.
264
 
265
+ [^18]: The sentry constructor and destructor can also perform additional
266
  implementation-dependent operations.
267
 
268
+ [^19]: This is done without causing an `ios::failure` to be thrown.
 
 
 
269
 
270
  [^20]: See, for example, the function signature
271
+ `ws(basic_istream&)` ([[istream.manip]]).
272
+
273
+ [^21]: See, for example, the function signature
274
  `dec(ios_base&)` ([[basefield.manip]]).
275
 
276
+ [^22]: This is done without causing an `ios::failure` to be thrown.
 
 
 
277
 
278
  [^23]: Note that this function is not overloaded on types `signed char`
279
  and `unsigned char`.
280
 
281
  [^24]: Note that this function is not overloaded on types `signed char`
282
  and `unsigned char`.
283
 
284
+ [^25]: Note that this function is not overloaded on types `signed char`
285
+ and `unsigned char`.
286
+
287
+ [^26]: Since the final input character is “extracted,” it is counted in
288
  the `gcount()`, even though it is not stored.
289
 
290
+ [^27]: This allows an input line which exactly fills the buffer, without
291
  setting `failbit`. This is different behavior than the historical
292
  AT&T implementation.
293
 
294
+ [^28]: This implies an empty input line will not cause `failbit` to be
295
  set.
296
 
297
+ [^29]: Note that this function is not overloaded on types `signed char`
298
  and `unsigned char`.
299
 
300
+ [^30]: The call `os.tie()->flush()` does not necessarily occur if the
301
  function can determine that no synchronization is necessary.
302
 
303
+ [^31]: The `sentry` constructor and destructor can also perform
304
  additional implementation-dependent operations.
305
 
306
+ [^32]: without causing an `ios::failure` to be thrown.
 
 
 
307
 
308
  [^33]: See, for example, the function signature
309
+ `endl(basic_ostream&)` ([[ostream.manip]]).
310
+
311
+ [^34]: See, for example, the function signature
312
  `dec(ios_base&)` ([[basefield.manip]]).
313
 
314
+ [^35]: without causing an `ios::failure` to be thrown.
 
 
 
315
 
316
  [^36]: Note that this function is not overloaded on types `signed char`
317
  and `unsigned char`.
318
 
319
+ [^37]: Note that this function is not overloaded on types `signed char`
320
+ and `unsigned char`.
321
+
322
+ [^38]: The expression `cin >>resetiosflags(ios_base::skipws)` clears
323
  `ios_base::skipws` in the format flags stored in the
324
  `basic_istream<charT,traits>` object `cin` (the same as
325
  `cin >>noskipws`), and the expression
326
  `cout << resetiosflags(ios_base::showbase)` clears
327
  `ios_base::showbase` in the format flags stored in the
328
  `basic_ostream<charT,traits>` object `cout` (the same as
329
  `cout <<noshowbase`).
330
 
331
+ [^39]: The macro `SEEK_END` is defined, and the function signatures
332
  `fopen(const char*, const char*)` and `fseek(FILE*, long, int)` are
333
  declared, in `<cstdio>` ([[c.files]]).
334
 
335
+ [^40]: The function signature `fclose(FILE*)` is declared in `<cstdio>`
336
  ([[c.files]]).