From Jason Turner

[streambuf.virt.get]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpn7l3aox2/{from.md → to.md} +12 -11
tmp/tmpn7l3aox2/{from.md → to.md} RENAMED
@@ -1,12 +1,13 @@
1
  ##### Get area <a id="streambuf.virt.get">[[streambuf.virt.get]]</a>
2
 
3
  ``` cpp
4
- streamsize showmanyc();\footnote{The morphemes of showmanyc\
5
- are ``es-how-many-see'', not ``show-manic''.}
6
  ```
7
 
 
 
8
  *Returns:* An estimate of the number of characters available in the
9
  sequence, or -1. If it returns a positive value, then successive calls
10
  to `underflow()` will not return `traits::eof()` until at least that
11
  number of characters have been extracted from the stream. If
12
  `showmanyc()` returns -1, then calls to `underflow()` or `uflow()` will
@@ -32,18 +33,10 @@ to `sbumpc()` would return `traits::eof()`.
32
 
33
  ``` cpp
34
  int_type underflow();
35
  ```
36
 
37
- *Remarks:* The public members of `basic_streambuf` call this virtual
38
- function only if `gptr()` is null or `gptr() >= egptr()`.
39
-
40
- *Returns:* `traits::to_int_type(c)`, where `c` is the first *character*
41
- of the *pending sequence*, without moving the input sequence position
42
- past it. If the pending sequence is null then the function returns
43
- `traits::eof()` to indicate failure.
44
-
45
  The *pending sequence* of characters is defined as the concatenation of
46
 
47
  - the empty sequence if `gptr()` is null, otherwise the characters in
48
  \[`gptr()`, `egptr()`), followed by
49
  - some (possibly empty) sequence of characters read from the input
@@ -69,12 +62,20 @@ that either
69
  in which case the characters in \[`eback()`, `gptr()`) agree with the
70
  last `gptr() - eback()` characters of the backup sequence, or
71
  - the characters in \[`gptr() - n`, `gptr()`) agree with the backup
72
  sequence (where `n` is the length of the backup sequence).
73
 
 
 
 
 
 
74
  *Default behavior:* Returns `traits::eof()`.
75
 
 
 
 
76
  ``` cpp
77
  int_type uflow();
78
  ```
79
 
80
  *Preconditions:* The constraints are the same as for `underflow()`,
@@ -82,10 +83,10 @@ except that the result character is transferred from the pending
82
  sequence to the backup sequence, and the pending sequence is not empty
83
  before the transfer.
84
 
85
  *Default behavior:* Calls `underflow()`. If `underflow()` returns
86
  `traits::eof()`, returns `traits::eof()`. Otherwise, returns the value
87
- of `traits::to_int_type(*gptr())` and increment the value of the next
88
  pointer for the input sequence.
89
 
90
  *Returns:* `traits::eof()` to indicate failure.
91
 
 
1
  ##### Get area <a id="streambuf.virt.get">[[streambuf.virt.get]]</a>
2
 
3
  ``` cpp
4
+ streamsize showmanyc();
 
5
  ```
6
 
7
+ [^13]
8
+
9
  *Returns:* An estimate of the number of characters available in the
10
  sequence, or -1. If it returns a positive value, then successive calls
11
  to `underflow()` will not return `traits::eof()` until at least that
12
  number of characters have been extracted from the stream. If
13
  `showmanyc()` returns -1, then calls to `underflow()` or `uflow()` will
 
33
 
34
  ``` cpp
35
  int_type underflow();
36
  ```
37
 
 
 
 
 
 
 
 
 
38
  The *pending sequence* of characters is defined as the concatenation of
39
 
40
  - the empty sequence if `gptr()` is null, otherwise the characters in
41
  \[`gptr()`, `egptr()`), followed by
42
  - some (possibly empty) sequence of characters read from the input
 
62
  in which case the characters in \[`eback()`, `gptr()`) agree with the
63
  last `gptr() - eback()` characters of the backup sequence, or
64
  - the characters in \[`gptr() - n`, `gptr()`) agree with the backup
65
  sequence (where `n` is the length of the backup sequence).
66
 
67
+ *Returns:* `traits::to_int_type(c)`, where `c` is the first *character*
68
+ of the *pending sequence*, without moving the input sequence position
69
+ past it. If the pending sequence is null then the function returns
70
+ `traits::eof()` to indicate failure.
71
+
72
  *Default behavior:* Returns `traits::eof()`.
73
 
74
+ *Remarks:* The public members of `basic_streambuf` call this virtual
75
+ function only if `gptr()` is null or `gptr() >= egptr()`.
76
+
77
  ``` cpp
78
  int_type uflow();
79
  ```
80
 
81
  *Preconditions:* The constraints are the same as for `underflow()`,
 
83
  sequence to the backup sequence, and the pending sequence is not empty
84
  before the transfer.
85
 
86
  *Default behavior:* Calls `underflow()`. If `underflow()` returns
87
  `traits::eof()`, returns `traits::eof()`. Otherwise, returns the value
88
+ of `traits::to_int_type(*gptr())` and increments the value of the next
89
  pointer for the input sequence.
90
 
91
  *Returns:* `traits::eof()` to indicate failure.
92