From Jason Turner

[streambuf.virt.put]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpui4fiwz0/{from.md → to.md} +28 -0
tmp/tmpui4fiwz0/{from.md → to.md} RENAMED
@@ -2,9 +2,37 @@
2
 
3
  ``` cpp
4
  streamsize xsputn(const char_type* s, streamsize n);
5
  ```
6
 
 
 
 
 
 
 
 
 
 
 
7
  ``` cpp
8
  int_type overflow(int_type c = traits::eof());
9
  ```
10
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
 
3
  ``` cpp
4
  streamsize xsputn(const char_type* s, streamsize n);
5
  ```
6
 
7
+ *Effects:* Writes up to `n` characters to the output sequence as if by
8
+ repeated calls to `sputc(c)`. The characters written are obtained from
9
+ successive elements of the array whose first element is designated by
10
+ `s`. Writing stops when either `n` characters have been written or a
11
+ call to `sputc(c)` would return `traits::eof()`. Is is unspecified
12
+ whether the function calls `overflow()` when `pptr() == epptr()` becomes
13
+ true or whether it achieves the same effects by other means.
14
+
15
+ *Returns:* The number of characters written.
16
+
17
  ``` cpp
18
  int_type overflow(int_type c = traits::eof());
19
  ```
20
 
21
+ *Effects:* Consumes some initial subsequence of the characters of the
22
+ *pending sequence*. The pending sequence is defined as the concatenation
23
+ of
24
+
25
+ *Remarks:* The member functions `sputc()` and `sputn()` call this
26
+ function in case that no room can be found in the put buffer enough to
27
+ accommodate the argument character sequence.
28
+
29
+ *Requires:* Every overriding definition of this virtual function shall
30
+ obey the following constraints:
31
+
32
+ *Returns:* `traits::eof()` or throws an exception if the function fails.
33
+
34
+ Otherwise, returns some value other than `traits::eof()` to indicate
35
+ success.[^16]
36
+
37
+ *Default behavior:* Returns `traits::eof()`.
38
+