From Jason Turner

[c.mb.wcs]

C++20 → C++23 6.9 KB 44 lines
Current Draft | LaTeX Source
Archived: C++20 | C++23
Markdown: C++20 | C++23
Explore in Adventure Game

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpextp12ie/{from.md → to.md} +28 -11
tmp/tmpextp12ie/{from.md → to.md} RENAMED
@@ -59,22 +59,24 @@ next multibyte character is complete and valid, it determines the values
59
  of the corresponding UTF-8 code units and then, if `pc8` is not a null
60
  pointer, stores the value of the first (or only) such code unit in the
61
  object pointed to by `pc8`. Subsequent calls will store successive UTF-8
62
  code units without consuming any additional input until all the code
63
  units have been stored. If the corresponding Unicode character is
64
- U+0000, the resulting state described is the initial conversion state.
 
65
 
66
  *Returns:* The first of the following that applies (given the current
67
  conversion state):
68
 
69
  - `0`, if the next `n` or fewer bytes complete the multibyte character
70
- that corresponds to the U+0000 Unicode character (which is the value
71
- stored).
72
  - between `1` and `n` (inclusive), if the next n or fewer bytes complete
73
- a valid multibyte character (which is the value stored); the value
74
- returned is the number of bytes that complete the multibyte character.
75
- - `(size_t)(-3)`, if the next character resulting from a previous call
 
76
  has been stored (no bytes from the input have been consumed by this
77
  call).
78
  - `(size_t)(-2)`, if the next `n` bytes contribute to an incomplete (but
79
  potentially valid) multibyte character, and all `n` bytes have been
80
  processed (no value is stored).
@@ -107,62 +109,69 @@ conversion state is unspecified.
107
  *Remarks:* Calls to `c8rtomb` with a null pointer argument for `s` may
108
  introduce a data race [[res.on.data.races]] with other calls to
109
  `c8rtomb` with a null pointer argument for `s`.
110
 
111
  <!-- Link reference definitions -->
 
112
  [basic.string]: #basic.string
 
113
  [basic.string.hash]: #basic.string.hash
114
  [basic.string.literals]: #basic.string.literals
115
- [basic.types]: basic.md#basic.types
116
  [c.mb.wcs]: #c.mb.wcs
117
  [c.strings]: #c.strings
118
  [cctype.syn]: #cctype.syn
119
  [char.traits]: #char.traits
 
120
  [char.traits.req]: #char.traits.req
121
  [char.traits.require]: #char.traits.require
122
  [char.traits.specializations]: #char.traits.specializations
123
  [char.traits.specializations.char]: #char.traits.specializations.char
124
  [char.traits.specializations.char16.t]: #char.traits.specializations.char16.t
125
  [char.traits.specializations.char32.t]: #char.traits.specializations.char32.t
126
  [char.traits.specializations.char8.t]: #char.traits.specializations.char8.t
 
127
  [char.traits.specializations.wchar.t]: #char.traits.specializations.wchar.t
128
  [char.traits.typedefs]: #char.traits.typedefs
 
 
129
  [container.requirements]: containers.md#container.requirements
130
  [container.requirements.general]: containers.md#container.requirements.general
131
- [container.seq.req]: containers.md#container.seq.req
132
  [cpp17.copyassignable]: #cpp17.copyassignable
133
  [cpp17.copyconstructible]: #cpp17.copyconstructible
134
  [cpp17.defaultconstructible]: #cpp17.defaultconstructible
135
  [cpp17.destructible]: #cpp17.destructible
136
  [cstring.syn]: #cstring.syn
137
  [cuchar.syn]: #cuchar.syn
138
  [cwchar.syn]: #cwchar.syn
139
  [cwctype.syn]: #cwctype.syn
140
- [defns.character.container]: library.md#defns.character.container
141
  [input.output]: input.md#input.output
142
  [intro.object]: basic.md#intro.object
143
- [iostate.flags]: input.md#iostate.flags
144
  [iostream.forward]: input.md#iostream.forward
145
  [iostreams.limits.pos]: input.md#iostreams.limits.pos
146
  [istream.formatted.reqmts]: input.md#istream.formatted.reqmts
147
  [istream.unformatted]: input.md#istream.unformatted
148
  [iterator.concept.contiguous]: iterators.md#iterator.concept.contiguous
 
149
  [iterator.range]: iterators.md#iterator.range
150
  [iterator.requirements.general]: iterators.md#iterator.requirements.general
151
  [library.c]: library.md#library.c
152
  [ostream.formatted.reqmts]: input.md#ostream.formatted.reqmts
153
  [random.access.iterators]: iterators.md#random.access.iterators
154
  [res.on.data.races]: library.md#res.on.data.races
 
155
  [string.access]: #string.access
156
  [string.accessors]: #string.accessors
157
  [string.append]: #string.append
158
  [string.assign]: #string.assign
159
  [string.capacity]: #string.capacity
160
  [string.classes]: #string.classes
 
161
  [string.cmp]: #string.cmp
162
  [string.compare]: #string.compare
163
  [string.cons]: #string.cons
 
164
  [string.conversions]: #string.conversions
165
  [string.copy]: #string.copy
166
  [string.ends.with]: #string.ends.with
167
  [string.erase]: #string.erase
168
  [string.erasure]: #string.erasure
@@ -189,26 +198,34 @@ introduce a data race [[res.on.data.races]] with other calls to
189
  [string.view.comparison]: #string.view.comparison
190
  [string.view.comparison.overloads]: #string.view.comparison.overloads
191
  [string.view.cons]: #string.view.cons
192
  [string.view.deduct]: #string.view.deduct
193
  [string.view.find]: #string.view.find
 
194
  [string.view.hash]: #string.view.hash
195
  [string.view.io]: #string.view.io
196
  [string.view.iterators]: #string.view.iterators
197
  [string.view.literals]: #string.view.literals
198
  [string.view.modifiers]: #string.view.modifiers
199
  [string.view.ops]: #string.view.ops
200
  [string.view.synop]: #string.view.synop
201
  [string.view.template]: #string.view.template
 
202
  [strings]: #strings
203
  [strings.general]: #strings.general
204
  [strings.summary]: #strings.summary
205
  [support.signal]: support.md#support.signal
 
 
 
206
  [unord.hash]: utilities.md#unord.hash
207
  [utility.swap]: utilities.md#utility.swap
208
 
209
  [^1]: If `eof()` can be held in `char_type` then some iostreams
210
  operations can give surprising results.
211
 
212
- [^2]: For example, as an argument to non-member functions `swap()`
 
 
 
213
  [[string.special]], `operator>{}>()` [[string.io]], and `getline()`
214
  [[string.io]], or as an argument to `basic_string::swap()`.
 
59
  of the corresponding UTF-8 code units and then, if `pc8` is not a null
60
  pointer, stores the value of the first (or only) such code unit in the
61
  object pointed to by `pc8`. Subsequent calls will store successive UTF-8
62
  code units without consuming any additional input until all the code
63
  units have been stored. If the corresponding Unicode character is
64
+ U+0000 (null), the resulting state described is the initial conversion
65
+ state.
66
 
67
  *Returns:* The first of the following that applies (given the current
68
  conversion state):
69
 
70
  - `0`, if the next `n` or fewer bytes complete the multibyte character
71
+ that corresponds to the U+0000 (null) Unicode character (which is the
72
+ value stored).
73
  - between `1` and `n` (inclusive), if the next n or fewer bytes complete
74
+ a valid multibyte character (whose first (or only) code unit is
75
+ stored); the value returned is the number of bytes that complete the
76
+ multibyte character.
77
+ - `(size_t)(-3)`, if the next code unit resulting from a previous call
78
  has been stored (no bytes from the input have been consumed by this
79
  call).
80
  - `(size_t)(-2)`, if the next `n` bytes contribute to an incomplete (but
81
  potentially valid) multibyte character, and all `n` bytes have been
82
  processed (no value is stored).
 
109
  *Remarks:* Calls to `c8rtomb` with a null pointer argument for `s` may
110
  introduce a data race [[res.on.data.races]] with other calls to
111
  `c8rtomb` with a null pointer argument for `s`.
112
 
113
  <!-- Link reference definitions -->
114
+ [basic.indet]: basic.md#basic.indet
115
  [basic.string]: #basic.string
116
+ [basic.string.general]: #basic.string.general
117
  [basic.string.hash]: #basic.string.hash
118
  [basic.string.literals]: #basic.string.literals
 
119
  [c.mb.wcs]: #c.mb.wcs
120
  [c.strings]: #c.strings
121
  [cctype.syn]: #cctype.syn
122
  [char.traits]: #char.traits
123
+ [char.traits.general]: #char.traits.general
124
  [char.traits.req]: #char.traits.req
125
  [char.traits.require]: #char.traits.require
126
  [char.traits.specializations]: #char.traits.specializations
127
  [char.traits.specializations.char]: #char.traits.specializations.char
128
  [char.traits.specializations.char16.t]: #char.traits.specializations.char16.t
129
  [char.traits.specializations.char32.t]: #char.traits.specializations.char32.t
130
  [char.traits.specializations.char8.t]: #char.traits.specializations.char8.t
131
+ [char.traits.specializations.general]: #char.traits.specializations.general
132
  [char.traits.specializations.wchar.t]: #char.traits.specializations.wchar.t
133
  [char.traits.typedefs]: #char.traits.typedefs
134
+ [cmp.categories]: support.md#cmp.categories
135
+ [container.reqmts]: containers.md#container.reqmts
136
  [container.requirements]: containers.md#container.requirements
137
  [container.requirements.general]: containers.md#container.requirements.general
 
138
  [cpp17.copyassignable]: #cpp17.copyassignable
139
  [cpp17.copyconstructible]: #cpp17.copyconstructible
140
  [cpp17.defaultconstructible]: #cpp17.defaultconstructible
141
  [cpp17.destructible]: #cpp17.destructible
142
  [cstring.syn]: #cstring.syn
143
  [cuchar.syn]: #cuchar.syn
144
  [cwchar.syn]: #cwchar.syn
145
  [cwctype.syn]: #cwctype.syn
146
+ [defns.character.container]: intro.md#defns.character.container
147
  [input.output]: input.md#input.output
148
  [intro.object]: basic.md#intro.object
 
149
  [iostream.forward]: input.md#iostream.forward
150
  [iostreams.limits.pos]: input.md#iostreams.limits.pos
151
  [istream.formatted.reqmts]: input.md#istream.formatted.reqmts
152
  [istream.unformatted]: input.md#istream.unformatted
153
  [iterator.concept.contiguous]: iterators.md#iterator.concept.contiguous
154
+ [iterator.concept.winc]: iterators.md#iterator.concept.winc
155
  [iterator.range]: iterators.md#iterator.range
156
  [iterator.requirements.general]: iterators.md#iterator.requirements.general
157
  [library.c]: library.md#library.c
158
  [ostream.formatted.reqmts]: input.md#ostream.formatted.reqmts
159
  [random.access.iterators]: iterators.md#random.access.iterators
160
  [res.on.data.races]: library.md#res.on.data.races
161
+ [sequence.reqmts]: containers.md#sequence.reqmts
162
  [string.access]: #string.access
163
  [string.accessors]: #string.accessors
164
  [string.append]: #string.append
165
  [string.assign]: #string.assign
166
  [string.capacity]: #string.capacity
167
  [string.classes]: #string.classes
168
+ [string.classes.general]: #string.classes.general
169
  [string.cmp]: #string.cmp
170
  [string.compare]: #string.compare
171
  [string.cons]: #string.cons
172
+ [string.contains]: #string.contains
173
  [string.conversions]: #string.conversions
174
  [string.copy]: #string.copy
175
  [string.ends.with]: #string.ends.with
176
  [string.erase]: #string.erase
177
  [string.erasure]: #string.erasure
 
198
  [string.view.comparison]: #string.view.comparison
199
  [string.view.comparison.overloads]: #string.view.comparison.overloads
200
  [string.view.cons]: #string.view.cons
201
  [string.view.deduct]: #string.view.deduct
202
  [string.view.find]: #string.view.find
203
+ [string.view.general]: #string.view.general
204
  [string.view.hash]: #string.view.hash
205
  [string.view.io]: #string.view.io
206
  [string.view.iterators]: #string.view.iterators
207
  [string.view.literals]: #string.view.literals
208
  [string.view.modifiers]: #string.view.modifiers
209
  [string.view.ops]: #string.view.ops
210
  [string.view.synop]: #string.view.synop
211
  [string.view.template]: #string.view.template
212
+ [string.view.template.general]: #string.view.template.general
213
  [strings]: #strings
214
  [strings.general]: #strings.general
215
  [strings.summary]: #strings.summary
216
  [support.signal]: support.md#support.signal
217
+ [temp.deduct]: temp.md#temp.deduct
218
+ [term.standard.layout.type]: basic.md#term.standard.layout.type
219
+ [term.trivially.copyable.type]: basic.md#term.trivially.copyable.type
220
  [unord.hash]: utilities.md#unord.hash
221
  [utility.swap]: utilities.md#utility.swap
222
 
223
  [^1]: If `eof()` can be held in `char_type` then some iostreams
224
  operations can give surprising results.
225
 
226
+ [^2]: Because `basic_string_view` refers to a constant sequence,
227
+ `iterator` and `const_iterator` are the same type.
228
+
229
+ [^3]: For example, as an argument to non-member functions `swap()`
230
  [[string.special]], `operator>{}>()` [[string.io]], and `getline()`
231
  [[string.io]], or as an argument to `basic_string::swap()`.