tmp/tmpbgvdic5a/{from.md → to.md}
RENAMED
|
@@ -59,44 +59,45 @@ shall also return `ok`.[^8]
|
|
| 59 |
|
| 60 |
[*Note 1*: As a result of operations on `state`, it can return `ok` or
|
| 61 |
`partial` and set `from_next == from` and
|
| 62 |
`to_next != to`. — *end note*]
|
| 63 |
|
| 64 |
-
*Remarks:* Its operations on `state` are unspecified.
|
| 65 |
-
|
| 66 |
-
[*Note 2*: This argument can be used, for example, to maintain shift
|
| 67 |
-
state, to specify conversion options (such as count only), or to
|
| 68 |
-
identify a cache of seek offsets. — *end note*]
|
| 69 |
-
|
| 70 |
*Returns:* An enumeration value, as summarized in
|
| 71 |
[[locale.codecvt.inout]].
|
| 72 |
|
| 73 |
**Table: `do_in/do_out` result values** <a id="locale.codecvt.inout">[locale.codecvt.inout]</a>
|
| 74 |
|
| 75 |
| Value | Meaning |
|
| 76 |
| --------- | ------------------------------------------------------------------------------------------------ |
|
| 77 |
| `ok` | completed the conversion |
|
| 78 |
| `partial` | not all source characters converted |
|
| 79 |
-
| `error` | encountered a character in {[}`from`, `from_end`{)} that
|
| 80 |
| `noconv` | `internT` and `externT` are the same type, and input sequence is identical to converted sequence |
|
| 81 |
|
| 82 |
|
| 83 |
A return value of `partial`, if `(from_next == from_end)`, indicates
|
| 84 |
that either the destination sequence has not absorbed all the available
|
| 85 |
destination elements, or that additional source elements are needed
|
| 86 |
before another destination element can be produced.
|
| 87 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 88 |
``` cpp
|
| 89 |
result do_unshift(stateT& state, externT* to, externT* to_end, externT*& to_next) const;
|
| 90 |
```
|
| 91 |
|
| 92 |
*Preconditions:* `(to <= to_end)` is well-defined and `true`; `state` is
|
| 93 |
initialized, if at the beginning of a sequence, or else is equal to the
|
| 94 |
result of converting the preceding characters in the sequence.
|
| 95 |
|
| 96 |
*Effects:* Places characters starting at `to` that should be appended to
|
| 97 |
terminate a sequence when the current `stateT` is given by `state`.[^9]
|
|
|
|
| 98 |
Stores no more than `(to_end - to)` destination elements, and leaves the
|
| 99 |
`to_next` pointer pointing one beyond the last element successfully
|
| 100 |
stored.
|
| 101 |
|
| 102 |
*Returns:* An enumeration value, as summarized in
|
|
|
|
| 59 |
|
| 60 |
[*Note 1*: As a result of operations on `state`, it can return `ok` or
|
| 61 |
`partial` and set `from_next == from` and
|
| 62 |
`to_next != to`. — *end note*]
|
| 63 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 64 |
*Returns:* An enumeration value, as summarized in
|
| 65 |
[[locale.codecvt.inout]].
|
| 66 |
|
| 67 |
**Table: `do_in/do_out` result values** <a id="locale.codecvt.inout">[locale.codecvt.inout]</a>
|
| 68 |
|
| 69 |
| Value | Meaning |
|
| 70 |
| --------- | ------------------------------------------------------------------------------------------------ |
|
| 71 |
| `ok` | completed the conversion |
|
| 72 |
| `partial` | not all source characters converted |
|
| 73 |
+
| `error` | encountered a character in {[}`from`, `from_end`{)} that cannot be converted |
|
| 74 |
| `noconv` | `internT` and `externT` are the same type, and input sequence is identical to converted sequence |
|
| 75 |
|
| 76 |
|
| 77 |
A return value of `partial`, if `(from_next == from_end)`, indicates
|
| 78 |
that either the destination sequence has not absorbed all the available
|
| 79 |
destination elements, or that additional source elements are needed
|
| 80 |
before another destination element can be produced.
|
| 81 |
|
| 82 |
+
*Remarks:* Its operations on `state` are unspecified.
|
| 83 |
+
|
| 84 |
+
[*Note 2*: This argument can be used, for example, to maintain shift
|
| 85 |
+
state, to specify conversion options (such as count only), or to
|
| 86 |
+
identify a cache of seek offsets. — *end note*]
|
| 87 |
+
|
| 88 |
``` cpp
|
| 89 |
result do_unshift(stateT& state, externT* to, externT* to_end, externT*& to_next) const;
|
| 90 |
```
|
| 91 |
|
| 92 |
*Preconditions:* `(to <= to_end)` is well-defined and `true`; `state` is
|
| 93 |
initialized, if at the beginning of a sequence, or else is equal to the
|
| 94 |
result of converting the preceding characters in the sequence.
|
| 95 |
|
| 96 |
*Effects:* Places characters starting at `to` that should be appended to
|
| 97 |
terminate a sequence when the current `stateT` is given by `state`.[^9]
|
| 98 |
+
|
| 99 |
Stores no more than `(to_end - to)` destination elements, and leaves the
|
| 100 |
`to_next` pointer pointing one beyond the last element successfully
|
| 101 |
stored.
|
| 102 |
|
| 103 |
*Returns:* An enumeration value, as summarized in
|