[locale.codecvt] - C++23 → Trunk

Files changed (1) hide show

tmp/tmpu3fmde2e/{from.md → to.md} +19 -22

tmp/tmpu3fmde2e/{from.md → to.md} RENAMED Viewed

@@ -1,8 +1,8 @@
-#### Class template `codecvt` <a id="locale.codecvt">[[locale.codecvt]]</a>
-##### General <a id="locale.codecvt.general">[[locale.codecvt.general]]</a>
 ``` cpp
 namespace std {
   class codecvt_base {
   public:
@@ -70,23 +70,20 @@ The `stateT` argument selects the pair of character encodings being
 mapped between.
 The specializations required in [[locale.category.facets]]
 [[locale.category]] convert the implementation-defined native character
 set. `codecvt<char, char, mbstate_t>` implements a degenerate
-conversion; it does not convert at all. The specialization
-`codecvt<char16_t, char8_t, mbstate_t>` converts between the UTF-16 and
-UTF-8 encoding forms, and the specialization
-`codecvt<char32_t, char8_t, mbstate_t>` converts between the UTF-32 and
-UTF-8 encoding forms. `codecvt<wchar_t, char, mbstate_t>` converts
-between the native character sets for ordinary and wide characters.
-Specializations on `mbstate_t` perform conversion between encodings
-known to the library implementer. Other encodings can be converted by
-specializing on a program-defined `stateT` type. Objects of type
-`stateT` can contain any state that is useful to communicate to or from
-the specialized `do_in` or `do_out` members.
-##### Members <a id="locale.codecvt.members">[[locale.codecvt.members]]</a>
 ``` cpp
 result out(
   stateT& state,
   const internT* from, const internT* from_end, const internT*& from_next,
@@ -134,11 +131,11 @@ int length(stateT& state, const externT* from, const externT* from_end, size_t m
 int max_length() const noexcept;
 ```
 *Returns:* `do_max_length()`.
-##### Virtual functions <a id="locale.codecvt.virtuals">[[locale.codecvt.virtuals]]</a>
 ``` cpp
 result do_out(
   stateT& state,
   const internT* from, const internT* from_end, const internT*& from_next,
@@ -160,13 +157,13 @@ the sequence.
 destination `to`. Converts no more than `(from_end - from)` source
 elements, and stores no more than `(to_end - to)` destination elements.
 Stops if it encounters a character it cannot convert. It always leaves
 the `from_next` and `to_next` pointers pointing one beyond the last
-element successfully converted. If returns `noconv`, `internT` and
-`externT` are the same type and the converted sequence is identical to
-the input sequence \[`from`, `from``next`). `to_next` is set equal to
 `to`, the value of `state` is unchanged, and there are no changes to the
 values in \[`to`, `to_end`).
 A `codecvt` facet that is used by `basic_filebuf` [[file.streams]] shall
 have the property that if
@@ -277,14 +274,14 @@ sequence.
 *Effects:* The effect on the `state` argument is as if it called
 `do_in(state, from, from_end, from, to, to + max, to)` for `to` pointing
 to a buffer of at least `max` elements.
-*Returns:* `(from_next-from)` where `from_next` is the largest value in
-the range \[`from`, `from_end`\] such that the sequence of values in the
-range \[`from`, `from_next`) represents `max` or fewer valid complete
-characters of type `internT`. The specialization
 `codecvt<char, char, mbstate_t>`, returns the lesser of `max` and
 `(from_end - from)`.
 ``` cpp
 int do_max_length() const noexcept;

+##### Class template `codecvt` <a id="locale.codecvt">[[locale.codecvt]]</a>
+###### General <a id="locale.codecvt.general">[[locale.codecvt.general]]</a>
 ``` cpp
 namespace std {
   class codecvt_base {
   public:
 mapped between.
 The specializations required in [[locale.category.facets]]
 [[locale.category]] convert the implementation-defined native character
 set. `codecvt<char, char, mbstate_t>` implements a degenerate
+conversion; it does not convert at all.
+`codecvt<wchar_t, char, mbstate_t>` converts between the native
+character sets for ordinary and wide characters. Specializations on
+`mbstate_t` perform conversion between encodings known to the library
+implementer. Other encodings can be converted by specializing on a
+program-defined `stateT` type. Objects of type `stateT` can contain any
+state that is useful to communicate to or from the specialized `do_in`
+or `do_out` members.
+###### Members <a id="locale.codecvt.members">[[locale.codecvt.members]]</a>
 ``` cpp
 result out(
   stateT& state,
   const internT* from, const internT* from_end, const internT*& from_next,
 int max_length() const noexcept;
 ```
 *Returns:* `do_max_length()`.
+###### Virtual functions <a id="locale.codecvt.virtuals">[[locale.codecvt.virtuals]]</a>
 ``` cpp
 result do_out(
   stateT& state,
   const internT* from, const internT* from_end, const internT*& from_next,
 destination `to`. Converts no more than `(from_end - from)` source
 elements, and stores no more than `(to_end - to)` destination elements.
 Stops if it encounters a character it cannot convert. It always leaves
 the `from_next` and `to_next` pointers pointing one beyond the last
+element successfully converted. If it returns `noconv`, `internT` and
+`externT` are the same type, and the converted sequence is identical to
+the input sequence \[`from`, `from``next`), `to_next` is set equal to
 `to`, the value of `state` is unchanged, and there are no changes to the
 values in \[`to`, `to_end`).
 A `codecvt` facet that is used by `basic_filebuf` [[file.streams]] shall
 have the property that if
 *Effects:* The effect on the `state` argument is as if it called
 `do_in(state, from, from_end, from, to, to + max, to)` for `to` pointing
 to a buffer of at least `max` elements.
+*Returns:* `(from_next - from)` where `from_next` is the largest value
+in the range \[`from`, `from_end`\] such that the sequence of values in
+the range \[`from`, `from_next`) represents `max` or fewer valid
+complete characters of type `internT`. The specialization
 `codecvt<char, char, mbstate_t>`, returns the lesser of `max` and
 `(from_end - from)`.
 ``` cpp
 int do_max_length() const noexcept;

Diff to HTML by rtfpessoa