From Jason Turner

[locale.time.put]

C++23 → Trunk 3.6 KB 28 lines
Current Draft | LaTeX Source
Archived: C++23
Markdown: C++23 | Trunk
Explore in Adventure Game

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpva2kl5cn/{from.md → to.md} +11 -11
tmp/tmpva2kl5cn/{from.md → to.md} RENAMED
@@ -1,6 +1,8 @@
1
- #### Class template `time_put` <a id="locale.time.put">[[locale.time.put]]</a>
 
 
2
 
3
  ``` cpp
4
  namespace std {
5
  template<class charT, class OutputIterator = ostreambuf_iterator<charT>>
6
  class time_put : public locale::facet {
@@ -24,11 +26,11 @@ namespace std {
24
  char format, char modifier) const;
25
  };
26
  }
27
  ```
28
 
29
- ##### Members <a id="locale.time.put.members">[[locale.time.put.members]]</a>
30
 
31
  ``` cpp
32
  iter_type put(iter_type s, ios_base& str, char_type fill, const tm* t,
33
  const charT* pattern, const charT* pat_end) const;
34
  iter_type put(iter_type s, ios_base& str, char_type fill, const tm* t,
@@ -43,27 +45,25 @@ 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`[^17]
49
-
50
- and a format specifier character `spec` as defined for the function
51
- `strftime`. If no modifier character is present, `mod` is zero. For each
52
- valid format sequence identified, calls
53
  `do_put(s, str, fill, t, spec, mod)`.
54
 
55
  The second form calls `do_put(s, str, fill, t, format, modifier)`.
56
 
57
- [*Note 1*: The `fill` argument can be used in the
58
  implementation-defined formats or by derivations. A space character is a
59
  reasonable default for this argument. — *end note*]
60
 
61
  *Returns:* An iterator pointing immediately after the last character
62
  produced.
63
 
64
- ##### Virtual functions <a id="locale.time.put.virtuals">[[locale.time.put.virtuals]]</a>
65
 
66
  ``` cpp
67
  iter_type do_put(iter_type s, ios_base&, char_type fill, const tm* t,
68
  char format, char modifier) const;
69
  ```
@@ -74,17 +74,17 @@ parameters `format` and `modifier`, interpreted identically as the
74
  format specifiers in the string argument to the standard library
75
  function `strftime()`, except that the sequence of characters produced
76
  for those specifiers that are described as depending on the C locale are
77
  instead *implementation-defined*.
78
 
79
- [*Note 2*: Interpretation of the `modifier` argument is
80
  implementation-defined. — *end note*]
81
 
82
  *Returns:* An iterator pointing immediately after the last character
83
  produced.
84
 
85
- [*Note 3*: The `fill` argument can be used in the
86
  implementation-defined formats or by derivations. A space character is a
87
  reasonable default for this argument. — *end note*]
88
 
89
  *Recommended practice:* Interpretation of the `modifier` should follow
90
  POSIX conventions. Implementations should refer to other standards such
 
1
+ ##### Class template `time_put` <a id="locale.time.put">[[locale.time.put]]</a>
2
+
3
+ ###### General <a id="locale.time.put.general">[[locale.time.put.general]]</a>
4
 
5
  ``` cpp
6
  namespace std {
7
  template<class charT, class OutputIterator = ostreambuf_iterator<charT>>
8
  class time_put : public locale::facet {
 
26
  char format, char modifier) const;
27
  };
28
  }
29
  ```
30
 
31
+ ###### Members <a id="locale.time.put.members">[[locale.time.put.members]]</a>
32
 
33
  ``` cpp
34
  iter_type put(iter_type s, ios_base& str, char_type fill, const tm* t,
35
  const charT* pattern, const charT* pat_end) const;
36
  iter_type put(iter_type s, ios_base& str, char_type fill, const tm* t,
 
45
  interleaved in the output in the order in which they appear in the
46
  pattern. Format sequences are identified by converting each character
47
  `c` to a `char` value as if by `ct.narrow(c, 0)`, where `ct` is a
48
  reference to `ctype<charT>` obtained from `str.getloc()`. The first
49
  character of each sequence is equal to `’%’`, followed by an optional
50
+ modifier character `mod` and a format specifier character `spec` as
51
+ defined for the function `strftime`. If no modifier character is
52
+ present, `mod` is zero. For each valid format sequence identified, calls
 
 
53
  `do_put(s, str, fill, t, spec, mod)`.
54
 
55
  The second form calls `do_put(s, str, fill, t, format, modifier)`.
56
 
57
+ [*Note 2*: The `fill` argument can be used in the
58
  implementation-defined formats or by derivations. A space character is a
59
  reasonable default for this argument. — *end note*]
60
 
61
  *Returns:* An iterator pointing immediately after the last character
62
  produced.
63
 
64
+ ###### Virtual functions <a id="locale.time.put.virtuals">[[locale.time.put.virtuals]]</a>
65
 
66
  ``` cpp
67
  iter_type do_put(iter_type s, ios_base&, char_type fill, const tm* t,
68
  char format, char modifier) const;
69
  ```
 
74
  format specifiers in the string argument to the standard library
75
  function `strftime()`, except that the sequence of characters produced
76
  for those specifiers that are described as depending on the C locale are
77
  instead *implementation-defined*.
78
 
79
+ [*Note 3*: Interpretation of the `modifier` argument is
80
  implementation-defined. — *end note*]
81
 
82
  *Returns:* An iterator pointing immediately after the last character
83
  produced.
84
 
85
+ [*Note 4*: The `fill` argument can be used in the
86
  implementation-defined formats or by derivations. A space character is a
87
  reasonable default for this argument. — *end note*]
88
 
89
  *Recommended practice:* Interpretation of the `modifier` should follow
90
  POSIX conventions. Implementations should refer to other standards such