From Jason Turner

[locale.time.put]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpcln5_x22/{from.md → to.md} +13 -11
tmp/tmpcln5_x22/{from.md → to.md} RENAMED
@@ -3,12 +3,12 @@
3
  ``` cpp
4
  namespace std {
5
  template <class charT, class OutputIterator = ostreambuf_iterator<charT>>
6
  class time_put : public locale::facet {
7
  public:
8
- typedef charT char_type;
9
- typedef OutputIterator iter_type;
10
 
11
  explicit time_put(size_t refs = 0);
12
 
13
  // the following is implemented in terms of other member functions.
14
  iter_type put(iter_type s, ios_base& f, char_type fill, const tm* tmb,
@@ -43,20 +43,20 @@ call to `do_put`; thus, format elements and other characters are
43
  interleaved in the output in the order in which they appear in the
44
  pattern. Format sequences are identified by converting each character
45
  `c` to a `char` value as if by `ct.narrow(c, 0)`, where `ct` is a
46
  reference to `ctype<charT>` obtained from `str.getloc()`. The first
47
  character of each sequence is equal to `’%’`, followed by an optional
48
- modifier character `mod`[^16] and a format specifier character `spec` as
49
  defined for the function `strftime`. If no modifier character is
50
  present, `mod` is zero. For each valid format sequence identified, calls
51
  `do_put(s, str, fill, t, spec, mod)`.
52
 
53
  The second form calls `do_put(s, str, fill, t, format, modifier)`.
54
 
55
- The `fill` argument may be used in the implementation-defined formats or
56
- by derivations. A space character is a reasonable default for this
57
- argument.
58
 
59
  *Returns:* An iterator pointing immediately after the last character
60
  produced.
61
 
62
  ##### `time_put` virtual functions <a id="locale.time.put.virtuals">[[locale.time.put.virtuals]]</a>
@@ -68,14 +68,16 @@ iter_type do_put(iter_type s, ios_base&, char_type fill, const tm* t,
68
 
69
  *Effects:* Formats the contents of the parameter `t` into characters
70
  placed on the output sequence `s`. Formatting is controlled by the
71
  parameters `format` and `modifier`, interpreted identically as the
72
  format specifiers in the string argument to the standard library
73
- function `strftime()`[^17], except that the sequence of characters
74
  produced for those specifiers that are described as depending on the C
75
- locale are instead *implementation-defined*.[^18]
76
 
77
  *Returns:* An iterator pointing immediately after the last character
78
- produced. The `fill` argument may be used in the implementation-defined
79
- formats or by derivations. A space character is a reasonable default for
80
- this argument.
 
 
81
 
 
3
  ``` cpp
4
  namespace std {
5
  template <class charT, class OutputIterator = ostreambuf_iterator<charT>>
6
  class time_put : public locale::facet {
7
  public:
8
+ using char_type = charT;
9
+ using iter_type = OutputIterator;
10
 
11
  explicit time_put(size_t refs = 0);
12
 
13
  // the following is implemented in terms of other member functions.
14
  iter_type put(iter_type s, ios_base& f, char_type fill, const tm* tmb,
 
43
  interleaved in the output in the order in which they appear in the
44
  pattern. Format sequences are identified by converting each character
45
  `c` to a `char` value as if by `ct.narrow(c, 0)`, where `ct` is a
46
  reference to `ctype<charT>` obtained from `str.getloc()`. The first
47
  character of each sequence is equal to `’%’`, followed by an optional
48
+ modifier character `mod`[^17] and a format specifier character `spec` as
49
  defined for the function `strftime`. If no modifier character is
50
  present, `mod` is zero. For each valid format sequence identified, calls
51
  `do_put(s, str, fill, t, spec, mod)`.
52
 
53
  The second form calls `do_put(s, str, fill, t, format, modifier)`.
54
 
55
+ [*Note 1*: The `fill` argument may be used in the
56
+ implementation-defined formats or by derivations. A space character is a
57
+ reasonable default for this argument. — *end note*]
58
 
59
  *Returns:* An iterator pointing immediately after the last character
60
  produced.
61
 
62
  ##### `time_put` virtual functions <a id="locale.time.put.virtuals">[[locale.time.put.virtuals]]</a>
 
68
 
69
  *Effects:* Formats the contents of the parameter `t` into characters
70
  placed on the output sequence `s`. Formatting is controlled by the
71
  parameters `format` and `modifier`, interpreted identically as the
72
  format specifiers in the string argument to the standard library
73
+ function `strftime()`[^18], except that the sequence of characters
74
  produced for those specifiers that are described as depending on the C
75
+ locale are instead *implementation-defined*.[^19]
76
 
77
  *Returns:* An iterator pointing immediately after the last character
78
+ produced.
79
+
80
+ [*Note 2*: The `fill` argument may be used in the
81
+ implementation-defined formats or by derivations. A space character is a
82
+ reasonable default for this argument. — *end note*]
83