tmp/tmpcgouxjzn/{from.md → to.md}
RENAMED
|
@@ -18,17 +18,17 @@ namespace std {
|
|
| 18 |
```
|
| 19 |
|
| 20 |
The contents and meaning of the header `<clocale>` are the same as the C
|
| 21 |
standard library header `<locale.h>`.
|
| 22 |
|
| 23 |
-
Calls to the function `setlocale` may introduce a data race
|
| 24 |
-
[[res.on.data.races]]
|
| 25 |
-
the functions listed in
|
| 26 |
|
| 27 |
-
ISO C 7.11
|
| 28 |
|
| 29 |
-
**Table: Potential `setlocale` data races** <a id="
|
| 30 |
|
| 31 |
| | | | | |
|
| 32 |
| --------- | ---------- | ----------- | ------------ | ---------- |
|
| 33 |
| `fprintf` | `isprint` | `iswdigit` | `localeconv` | `tolower` |
|
| 34 |
| `fscanf` | `ispunct` | `iswgraph` | `mblen` | `toupper` |
|
|
@@ -70,23 +70,25 @@ ISO C 7.11.
|
|
| 70 |
[facet.num.put.members]: #facet.num.put.members
|
| 71 |
[facet.num.put.virtuals]: #facet.num.put.virtuals
|
| 72 |
[facet.numpunct]: #facet.numpunct
|
| 73 |
[facet.numpunct.members]: #facet.numpunct.members
|
| 74 |
[facet.numpunct.virtuals]: #facet.numpunct.virtuals
|
| 75 |
-
[facets.examples]: #facets.examples
|
| 76 |
[file.streams]: input.md#file.streams
|
| 77 |
[ios.base]: input.md#ios.base
|
| 78 |
[istream.formatted]: input.md#istream.formatted
|
| 79 |
[istream.formatted.reqmts]: input.md#istream.formatted.reqmts
|
| 80 |
[iterator.requirements]: iterators.md#iterator.requirements
|
| 81 |
[lex.charset]: lex.md#lex.charset
|
| 82 |
[locale]: #locale
|
| 83 |
[locale.categories]: #locale.categories
|
| 84 |
[locale.category]: #locale.category
|
|
|
|
| 85 |
[locale.codecvt]: #locale.codecvt
|
| 86 |
[locale.codecvt.byname]: #locale.codecvt.byname
|
|
|
|
| 87 |
[locale.codecvt.members]: #locale.codecvt.members
|
|
|
|
| 88 |
[locale.codecvt.virtuals]: #locale.codecvt.virtuals
|
| 89 |
[locale.collate]: #locale.collate
|
| 90 |
[locale.collate.byname]: #locale.collate.byname
|
| 91 |
[locale.collate.members]: #locale.collate.members
|
| 92 |
[locale.collate.virtuals]: #locale.collate.virtuals
|
|
@@ -117,51 +119,50 @@ ISO C 7.11.
|
|
| 117 |
[locale.nm.put]: #locale.nm.put
|
| 118 |
[locale.num.get]: #locale.num.get
|
| 119 |
[locale.numpunct]: #locale.numpunct
|
| 120 |
[locale.numpunct.byname]: #locale.numpunct.byname
|
| 121 |
[locale.operators]: #locale.operators
|
|
|
|
| 122 |
[locale.statics]: #locale.statics
|
| 123 |
[locale.syn]: #locale.syn
|
| 124 |
[locale.time.get]: #locale.time.get
|
| 125 |
[locale.time.get.byname]: #locale.time.get.byname
|
|
|
|
| 126 |
[locale.time.get.members]: #locale.time.get.members
|
| 127 |
[locale.time.get.virtuals]: #locale.time.get.virtuals
|
| 128 |
[locale.time.put]: #locale.time.put
|
| 129 |
[locale.time.put.byname]: #locale.time.put.byname
|
| 130 |
[locale.time.put.members]: #locale.time.put.members
|
| 131 |
[locale.time.put.virtuals]: #locale.time.put.virtuals
|
| 132 |
[locale.types]: #locale.types
|
| 133 |
[locales]: #locales
|
| 134 |
[localization]: #localization
|
| 135 |
[localization.general]: #localization.general
|
|
|
|
| 136 |
[ostream.formatted.reqmts]: input.md#ostream.formatted.reqmts
|
| 137 |
[res.on.data.races]: library.md#res.on.data.races
|
| 138 |
[sequence.reqmts]: containers.md#sequence.reqmts
|
| 139 |
-
[
|
| 140 |
-
[tab:
|
| 141 |
-
[tab:
|
| 142 |
-
[tab:localization.convert.result.values.unshift]: #tab:localization.convert.result.values.unshift
|
| 143 |
-
[tab:localization.lib.summary]: #tab:localization.lib.summary
|
| 144 |
-
[tab:localization.required.specializations]: #tab:localization.required.specializations
|
| 145 |
-
[tab:setlocale.data.races]: #tab:setlocale.data.races
|
| 146 |
[vector]: containers.md#vector
|
| 147 |
|
| 148 |
[^1]: In this subclause, the type name `struct tm` is an incomplete type
|
| 149 |
that is defined in `<ctime>`.
|
| 150 |
|
| 151 |
-
[^2]: Note that in the call to `put` the stream is implicitly converted
|
| 152 |
to an `ostreambuf_iterator<charT, traits>`.
|
| 153 |
|
| 154 |
[^3]: This is a complete list of requirements; there are no other
|
| 155 |
requirements. Thus, a facet class need not have a public copy
|
| 156 |
constructor, assignment, default constructor, destructor, etc.
|
| 157 |
|
| 158 |
[^4]: When used in a loop, it is faster to cache the `ctype<>` facet and
|
| 159 |
use it directly, or use the vector form of `ctype<>::is`.
|
| 160 |
|
| 161 |
[^5]: The char argument of `do_widen` is intended to accept values
|
| 162 |
-
derived from character
|
| 163 |
encoding.
|
| 164 |
|
| 165 |
[^6]: In other words, the transformed character is not a member of any
|
| 166 |
character classification that `c` is not also a member of.
|
| 167 |
|
|
@@ -209,12 +210,12 @@ ISO C 7.11.
|
|
| 209 |
vendors do.
|
| 210 |
|
| 211 |
[^18]: Interpretation of the `modifier` argument is
|
| 212 |
implementation-defined, but should follow POSIX conventions.
|
| 213 |
|
| 214 |
-
[^19]: Implementations
|
| 215 |
-
|
| 216 |
|
| 217 |
[^20]: The semantics here are different from `ct.narrow`.
|
| 218 |
|
| 219 |
[^21]: An array of `char`, rather than an array of `part`, is specified
|
| 220 |
for `pattern::field` purely for efficiency.
|
|
@@ -223,15 +224,11 @@ ISO C 7.11.
|
|
| 223 |
|
| 224 |
[^23]: In common U.S. locales this is `’,’`.
|
| 225 |
|
| 226 |
[^24]: To specify grouping by 3s, the value is `"\003"` *not* `"3"`.
|
| 227 |
|
| 228 |
-
[^25]:
|
| 229 |
-
`true`) this is typically four characters long, usually three
|
| 230 |
-
letters and a space.
|
| 231 |
|
| 232 |
-
[^26]:
|
| 233 |
|
| 234 |
-
[^27]:
|
| 235 |
-
|
| 236 |
-
[^28]: Note that the international symbol returned by `do_curr_sym()`
|
| 237 |
usually contains a space, itself; for example, `"USD "`.
|
|
|
|
| 18 |
```
|
| 19 |
|
| 20 |
The contents and meaning of the header `<clocale>` are the same as the C
|
| 21 |
standard library header `<locale.h>`.
|
| 22 |
|
| 23 |
+
Calls to the function `setlocale` may introduce a data race
|
| 24 |
+
[[res.on.data.races]] with other calls to `setlocale` or with calls to
|
| 25 |
+
the functions listed in [[setlocale.data.races]].
|
| 26 |
|
| 27 |
+
See also: ISO C 7.11
|
| 28 |
|
| 29 |
+
**Table: Potential `setlocale` data races** <a id="setlocale.data.races">[setlocale.data.races]</a>
|
| 30 |
|
| 31 |
| | | | | |
|
| 32 |
| --------- | ---------- | ----------- | ------------ | ---------- |
|
| 33 |
| `fprintf` | `isprint` | `iswdigit` | `localeconv` | `tolower` |
|
| 34 |
| `fscanf` | `ispunct` | `iswgraph` | `mblen` | `toupper` |
|
|
|
|
| 70 |
[facet.num.put.members]: #facet.num.put.members
|
| 71 |
[facet.num.put.virtuals]: #facet.num.put.virtuals
|
| 72 |
[facet.numpunct]: #facet.numpunct
|
| 73 |
[facet.numpunct.members]: #facet.numpunct.members
|
| 74 |
[facet.numpunct.virtuals]: #facet.numpunct.virtuals
|
|
|
|
| 75 |
[file.streams]: input.md#file.streams
|
| 76 |
[ios.base]: input.md#ios.base
|
| 77 |
[istream.formatted]: input.md#istream.formatted
|
| 78 |
[istream.formatted.reqmts]: input.md#istream.formatted.reqmts
|
| 79 |
[iterator.requirements]: iterators.md#iterator.requirements
|
| 80 |
[lex.charset]: lex.md#lex.charset
|
| 81 |
[locale]: #locale
|
| 82 |
[locale.categories]: #locale.categories
|
| 83 |
[locale.category]: #locale.category
|
| 84 |
+
[locale.category.facets]: #locale.category.facets
|
| 85 |
[locale.codecvt]: #locale.codecvt
|
| 86 |
[locale.codecvt.byname]: #locale.codecvt.byname
|
| 87 |
+
[locale.codecvt.inout]: #locale.codecvt.inout
|
| 88 |
[locale.codecvt.members]: #locale.codecvt.members
|
| 89 |
+
[locale.codecvt.unshift]: #locale.codecvt.unshift
|
| 90 |
[locale.codecvt.virtuals]: #locale.codecvt.virtuals
|
| 91 |
[locale.collate]: #locale.collate
|
| 92 |
[locale.collate.byname]: #locale.collate.byname
|
| 93 |
[locale.collate.members]: #locale.collate.members
|
| 94 |
[locale.collate.virtuals]: #locale.collate.virtuals
|
|
|
|
| 119 |
[locale.nm.put]: #locale.nm.put
|
| 120 |
[locale.num.get]: #locale.num.get
|
| 121 |
[locale.numpunct]: #locale.numpunct
|
| 122 |
[locale.numpunct.byname]: #locale.numpunct.byname
|
| 123 |
[locale.operators]: #locale.operators
|
| 124 |
+
[locale.spec]: #locale.spec
|
| 125 |
[locale.statics]: #locale.statics
|
| 126 |
[locale.syn]: #locale.syn
|
| 127 |
[locale.time.get]: #locale.time.get
|
| 128 |
[locale.time.get.byname]: #locale.time.get.byname
|
| 129 |
+
[locale.time.get.dogetdate]: #locale.time.get.dogetdate
|
| 130 |
[locale.time.get.members]: #locale.time.get.members
|
| 131 |
[locale.time.get.virtuals]: #locale.time.get.virtuals
|
| 132 |
[locale.time.put]: #locale.time.put
|
| 133 |
[locale.time.put.byname]: #locale.time.put.byname
|
| 134 |
[locale.time.put.members]: #locale.time.put.members
|
| 135 |
[locale.time.put.virtuals]: #locale.time.put.virtuals
|
| 136 |
[locale.types]: #locale.types
|
| 137 |
[locales]: #locales
|
| 138 |
[localization]: #localization
|
| 139 |
[localization.general]: #localization.general
|
| 140 |
+
[localization.summary]: #localization.summary
|
| 141 |
[ostream.formatted.reqmts]: input.md#ostream.formatted.reqmts
|
| 142 |
[res.on.data.races]: library.md#res.on.data.races
|
| 143 |
[sequence.reqmts]: containers.md#sequence.reqmts
|
| 144 |
+
[setlocale.data.races]: #setlocale.data.races
|
| 145 |
+
[tab:locale.category.facets]: #tab:locale.category.facets
|
| 146 |
+
[tab:locale.spec]: #tab:locale.spec
|
|
|
|
|
|
|
|
|
|
|
|
|
| 147 |
[vector]: containers.md#vector
|
| 148 |
|
| 149 |
[^1]: In this subclause, the type name `struct tm` is an incomplete type
|
| 150 |
that is defined in `<ctime>`.
|
| 151 |
|
| 152 |
+
[^2]: Note that in the call to `put`, the stream is implicitly converted
|
| 153 |
to an `ostreambuf_iterator<charT, traits>`.
|
| 154 |
|
| 155 |
[^3]: This is a complete list of requirements; there are no other
|
| 156 |
requirements. Thus, a facet class need not have a public copy
|
| 157 |
constructor, assignment, default constructor, destructor, etc.
|
| 158 |
|
| 159 |
[^4]: When used in a loop, it is faster to cache the `ctype<>` facet and
|
| 160 |
use it directly, or use the vector form of `ctype<>::is`.
|
| 161 |
|
| 162 |
[^5]: The char argument of `do_widen` is intended to accept values
|
| 163 |
+
derived from *character-literal*s for conversion to the locale’s
|
| 164 |
encoding.
|
| 165 |
|
| 166 |
[^6]: In other words, the transformed character is not a member of any
|
| 167 |
character classification that `c` is not also a member of.
|
| 168 |
|
|
|
|
| 210 |
vendors do.
|
| 211 |
|
| 212 |
[^18]: Interpretation of the `modifier` argument is
|
| 213 |
implementation-defined, but should follow POSIX conventions.
|
| 214 |
|
| 215 |
+
[^19]: Implementations should refer to other standards such as POSIX for
|
| 216 |
+
these definitions.
|
| 217 |
|
| 218 |
[^20]: The semantics here are different from `ct.narrow`.
|
| 219 |
|
| 220 |
[^21]: An array of `char`, rather than an array of `part`, is specified
|
| 221 |
for `pattern::field` purely for efficiency.
|
|
|
|
| 224 |
|
| 225 |
[^23]: In common U.S. locales this is `’,’`.
|
| 226 |
|
| 227 |
[^24]: To specify grouping by 3s, the value is `"\003"` *not* `"3"`.
|
| 228 |
|
| 229 |
+
[^25]: This is usually the empty string.
|
|
|
|
|
|
|
| 230 |
|
| 231 |
+
[^26]: In common U.S. locales, this is 2.
|
| 232 |
|
| 233 |
+
[^27]: Note that the international symbol returned by `do_curr_symbol()`
|
|
|
|
|
|
|
| 234 |
usually contains a space, itself; for example, `"USD "`.
|