From Jason Turner

[locale.time.get.members]

C++14 → C++17 5.0 KB 51 lines
Current Draft | LaTeX Source
Archived: C++14 | C++17
Markdown: C++14 | C++17
Explore in Adventure Game

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpe4svnjmg/{from.md → to.md} +24 -23
tmp/tmpe4svnjmg/{from.md → to.md} RENAMED
@@ -2,65 +2,65 @@
2
 
3
  ``` cpp
4
  dateorder date_order() const;
5
  ```
6
 
7
- *Returns:* `do_date_order()`
8
 
9
  ``` cpp
10
  iter_type get_time(iter_type s, iter_type end, ios_base& str,
11
  ios_base::iostate& err, tm* t) const;
12
  ```
13
 
14
- *Returns:* `do_get_time(s, end, str, err, t)`
15
 
16
  ``` cpp
17
  iter_type get_date(iter_type s, iter_type end, ios_base& str,
18
  ios_base::iostate& err, tm* t) const;
19
  ```
20
 
21
- *Returns:* `do_get_date(s, end, str, err, t)`
22
 
23
  ``` cpp
24
  iter_type get_weekday(iter_type s, iter_type end, ios_base& str,
25
  ios_base::iostate& err, tm* t) const;
26
  iter_type get_monthname(iter_type s, iter_type end, ios_base& str,
27
  ios_base::iostate& err, tm* t) const;
28
  ```
29
 
30
  *Returns:* `do_get_weekday(s, end, str, err, t)` or
31
- `do_get_monthname(s, end, str, err, t)`
32
 
33
  ``` cpp
34
  iter_type get_year(iter_type s, iter_type end, ios_base& str,
35
  ios_base::iostate& err, tm* t) const;
36
  ```
37
 
38
- *Returns:* `do_get_year(s, end, str, err, t)`
39
 
40
  ``` cpp
41
- iter_type get(iter_type s, iter_type end, ios_base& f,
42
- ios_base::iostate& err, tm* t, char format, char modifier = 0) const;
43
  ```
44
 
45
- *Returns:* `do_get(s, end, f, err, t, format, modifier)`
46
 
47
  ``` cpp
48
- iter_type get(iter_type s, iter_type end, ios_base& f,
49
- ios_base::iostate& err, tm* t, const char_type* fmt, const char_type* fmtend) const;
50
  ```
51
 
52
  *Requires:* \[`fmt`, `fmtend`) shall be a valid range.
53
 
54
  *Effects:* The function starts by evaluating `err = ios_base::goodbit`.
55
  It then enters a loop, reading zero or more characters from `s` at each
56
  iteration. Unless otherwise specified below, the loop terminates when
57
  the first of the following conditions holds:
58
 
59
- - The expression `fmt == fmtend` evaluates to true.
60
- - The expression `err == ios_base::goodbit` evaluates to false.
61
- - The expression `s == end` evaluates to true, in which case the
62
  function evaluates `err = ios_base::eofbit | ios_base::failbit`.
63
  - The next element of `fmt` is equal to `’%’`, optionally followed by a
64
  modifier character, followed by a conversion specifier character,
65
  `format`, together forming a conversion specification valid for the
66
  ISO/IEC 9945 function `strptime`. If the number of elements in the
@@ -71,22 +71,23 @@ the first of the following conditions holds:
71
  value of `modifier` is `’\0’` when the optional modifier is absent
72
  from the conversion specification. If `err == ios_base::goodbit` holds
73
  after the evaluation of the expression, the function increments `fmt`
74
  to point just past the end of the conversion specification and
75
  continues looping.
76
- - The expression `isspace(*fmt, f.getloc())` evaluates to true, in which
77
- case the function first increments `fmt` until
78
- `fmt == fmtend || !isspace(*fmt, f.getloc())` evaluates to true, then
79
- advances `s` until `s == end || !isspace(*s, f.getloc())` is true, and
80
- finally resumes looping.
81
  - The next character read from `s` matches the element pointed to by
82
  `fmt` in a case-insensitive comparison, in which case the function
83
  evaluates `++fmt, ++s` and continues looping. Otherwise, the function
84
  evaluates `err = ios_base::failbit`.
85
 
86
- The function uses the `ctype<charT>` facet installed in `f`’s locale to
87
- determine valid whitespace characters. It is unspecified by what means
88
- the function performs case-insensitive comparison or whether
89
- multi-character sequences are considered while doing so.
 
90
 
91
- *Returns:* `s`
92
 
 
2
 
3
  ``` cpp
4
  dateorder date_order() const;
5
  ```
6
 
7
+ *Returns:* `do_date_order()`.
8
 
9
  ``` cpp
10
  iter_type get_time(iter_type s, iter_type end, ios_base& str,
11
  ios_base::iostate& err, tm* t) const;
12
  ```
13
 
14
+ *Returns:* `do_get_time(s, end, str, err, t)`.
15
 
16
  ``` cpp
17
  iter_type get_date(iter_type s, iter_type end, ios_base& str,
18
  ios_base::iostate& err, tm* t) const;
19
  ```
20
 
21
+ *Returns:* `do_get_date(s, end, str, err, t)`.
22
 
23
  ``` cpp
24
  iter_type get_weekday(iter_type s, iter_type end, ios_base& str,
25
  ios_base::iostate& err, tm* t) const;
26
  iter_type get_monthname(iter_type s, iter_type end, ios_base& str,
27
  ios_base::iostate& err, tm* t) const;
28
  ```
29
 
30
  *Returns:* `do_get_weekday(s, end, str, err, t)` or
31
+ `do_get_monthname(s, end, str, err, t)`.
32
 
33
  ``` cpp
34
  iter_type get_year(iter_type s, iter_type end, ios_base& str,
35
  ios_base::iostate& err, tm* t) const;
36
  ```
37
 
38
+ *Returns:* `do_get_year(s, end, str, err, t)`.
39
 
40
  ``` cpp
41
+ iter_type get(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err,
42
+ tm* t, char format, char modifier = 0) const;
43
  ```
44
 
45
+ *Returns:* `do_get(s, end, f, err, t, format, modifier)`.
46
 
47
  ``` cpp
48
+ iter_type get(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err,
49
+ tm* t, const char_type* fmt, const char_type* fmtend) const;
50
  ```
51
 
52
  *Requires:* \[`fmt`, `fmtend`) shall be a valid range.
53
 
54
  *Effects:* The function starts by evaluating `err = ios_base::goodbit`.
55
  It then enters a loop, reading zero or more characters from `s` at each
56
  iteration. Unless otherwise specified below, the loop terminates when
57
  the first of the following conditions holds:
58
 
59
+ - The expression `fmt == fmtend` evaluates to `true`.
60
+ - The expression `err == ios_base::goodbit` evaluates to `false`.
61
+ - The expression `s == end` evaluates to `true`, in which case the
62
  function evaluates `err = ios_base::eofbit | ios_base::failbit`.
63
  - The next element of `fmt` is equal to `’%’`, optionally followed by a
64
  modifier character, followed by a conversion specifier character,
65
  `format`, together forming a conversion specification valid for the
66
  ISO/IEC 9945 function `strptime`. If the number of elements in the
 
71
  value of `modifier` is `’\0’` when the optional modifier is absent
72
  from the conversion specification. If `err == ios_base::goodbit` holds
73
  after the evaluation of the expression, the function increments `fmt`
74
  to point just past the end of the conversion specification and
75
  continues looping.
76
+ - The expression `isspace(*fmt, f.getloc())` evaluates to `true`, in
77
+ which case the function first increments `fmt` until
78
+ `fmt == fmtend || !isspace(*fmt, f.getloc())` evaluates to `true`,
79
+ then advances `s` until `s == end || !isspace(*s, f.getloc())` is
80
+ `true`, and finally resumes looping.
81
  - The next character read from `s` matches the element pointed to by
82
  `fmt` in a case-insensitive comparison, in which case the function
83
  evaluates `++fmt, ++s` and continues looping. Otherwise, the function
84
  evaluates `err = ios_base::failbit`.
85
 
86
+ [*Note 1*: The function uses the `ctype<charT>` facet installed in
87
+ `f`’s locale to determine valid whitespace characters. It is unspecified
88
+ by what means the function performs case-insensitive comparison or
89
+ whether multi-character sequences are considered while doing
90
+ so. — *end note*]
91
 
92
+ *Returns:* `s`.
93