[c.locales] - C++14 → C++17

Files changed (1) hide show

tmp/tmps6b2g73e/{from.md → to.md} +55 -35

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

@@ -1,15 +1,35 @@
 ## C library locales <a id="c.locales">[[c.locales]]</a>
-Table  [[tab:localization.hdr.clocale]] describes header `<clocale>`.
-The contents are the same as the Standard C library header `<locale.h>`.
 Calls to the function `setlocale` may introduce a data race (
 [[res.on.data.races]]) with other calls to `setlocale` or with calls to
 the functions listed in Table  [[tab:setlocale.data.races]].
 **Table: Potential `setlocale` data races** <a id="tab:setlocale.data.races">[tab:setlocale.data.races]</a>
 |           |            |             |              |            |
 | --------- | ---------- | ----------- | ------------ | ---------- |
 | `fprintf` | `isprint`  | `iswdigit`  | `localeconv` | `tolower`  |
@@ -21,31 +41,29 @@ the functions listed in Table  [[tab:setlocale.data.races]].
 | `isdigit` | `iswblank` | `iswupper`  | `strerror`   | `wcstombs` |
 | `isgraph` | `iswcntrl` | `iswxdigit` | `strtod`     | `wcsxfrm`  |
 | `islower` | `iswctype` | `isxdigit`  | `strxfrm`    | `wctomb`   |
-ISO C Clause 7.4.
 <!-- Link reference definitions -->
 [alg.lex.comparison]: algorithms.md#alg.lex.comparison
 [alg.sort]: algorithms.md#alg.sort
 [algorithms]: algorithms.md#algorithms
-[basic.start.init]: basic.md#basic.start.init
 [bitmask.types]: library.md#bitmask.types
 [c.files]: input.md#c.files
 [c.locales]: #c.locales
 [category.collate]: #category.collate
 [category.ctype]: #category.ctype
 [category.messages]: #category.messages
 [category.monetary]: #category.monetary
 [category.numeric]: #category.numeric
 [category.time]: #category.time
 [classification]: #classification
 [conversions]: #conversions
-[conversions.buffer]: #conversions.buffer
 [conversions.character]: #conversions.character
-[conversions.string]: #conversions.string
 [facet.ctype.char.dtor]: #facet.ctype.char.dtor
 [facet.ctype.char.members]: #facet.ctype.char.members
 [facet.ctype.char.statics]: #facet.ctype.char.statics
 [facet.ctype.char.virtuals]: #facet.ctype.char.virtuals
 [facet.ctype.special]: #facet.ctype.special
@@ -102,11 +120,10 @@ ISO C Clause 7.4.
 [locale.num.get]: #locale.num.get
 [locale.numpunct]: #locale.numpunct
 [locale.numpunct.byname]: #locale.numpunct.byname
 [locale.operators]: #locale.operators
 [locale.statics]: #locale.statics
-[locale.stdcvt]: #locale.stdcvt
 [locale.syn]: #locale.syn
 [locale.time.get]: #locale.time.get
 [locale.time.get.byname]: #locale.time.get.byname
 [locale.time.get.members]: #locale.time.get.members
 [locale.time.get.virtuals]: #locale.time.get.virtuals
@@ -123,11 +140,10 @@ ISO C Clause 7.4.
 [sequence.reqmts]: containers.md#sequence.reqmts
 [tab:lib.locale.time.get.virtuals.dogetdate]: #tab:lib.locale.time.get.virtuals.dogetdate
 [tab:localization.category.facets]: #tab:localization.category.facets
 [tab:localization.convert.result.values.out.in]: #tab:localization.convert.result.values.out.in
 [tab:localization.convert.result.values.unshift]: #tab:localization.convert.result.values.unshift
-[tab:localization.hdr.clocale]: #tab:localization.hdr.clocale
 [tab:localization.lib.summary]: #tab:localization.lib.summary
 [tab:localization.required.specializations]: #tab:localization.required.specializations
 [tab:setlocale.data.races]: #tab:setlocale.data.races
 [vector]: containers.md#vector
@@ -135,85 +151,89 @@ ISO C Clause 7.4.
     that is defined in `<ctime>`.
 [^2]: Note that in the call to `put` the stream is implicitly converted
     to an `ostreambuf_iterator<charT, traits>`.
-[^3]: When used in a loop, it is faster to cache the `ctype<>` facet and
     use it directly, or use the vector form of `ctype<>::is`.
-[^4]: The char argument of `do_widen` is intended to accept values
     derived from character literals for conversion to the locale’s
     encoding.
-[^5]: In other words, the transformed character is not a member of any
     character classification that `c` is not also a member of.
-[^6]: Only the `char` (not `unsigned char` and `signed char`) form is
     provided. The specialization is specified in the standard, and not
     left as an implementation detail, because it affects the derivation
     interface for `ctype<char>`.
-[^7]: Informally, this means that `basic_filebuf` assumes that the
     mappings from internal to external characters is 1 to N: a `codecvt`
     facet that is used by `basic_filebuf` must be able to translate
     characters one internal character at a time.
-[^8]: Typically these will be characters to return the state to
-    `stateT()`
-[^9]: If `encoding()` yields -1, then more than `max_length()` `externT`
-    elements may be consumed when producing a single `internT`
     character, and additional `externT` elements may appear at the end
     of a sequence after those that yield the final `internT` character.
-[^10]: Parsing `"-1"` correctly into, e.g., an `unsigned short` requires
     that the corresponding member `get()` at least extract the sign
     before delegating.
-[^11]: The conversion specification `#o` generates a leading `0` which
     is *not* a padding character.
-[^12]: Thus, the string `"\003"` specifies groups of 3 digits each, and
     `"3"` probably indicates groups of 51 (!) digits each, because 51 is
     the ASCII value of `"3"`.
-[^13]: This function is useful when one string is being compared to many
     other strings.
-[^14]: In other words, user confirmation is required for reliable
     parsing of user-entered dates and times, but machine-generated
     formats can be parsed reliably. This allows parsers to be aggressive
     about interpreting user variations on standard formats.
-[^15]: This function is intended as a convenience only, for common
     formats, and may return `no_order` in valid locales.
-[^16]: Although the C programming language defines no modifiers, most
     vendors do.
-[^17]: Interpretation of the `modifier` argument is
     implementation-defined, but should follow POSIX conventions.
-[^18]: Implementations are encouraged to refer to other standards such
     as POSIX for these definitions.
-[^19]: The semantics here are different from `ct.narrow`.
-[^20]: An array of `char`, rather than an array of `part`, is specified
     for `pattern::field` purely for efficiency.
-[^21]: In common U.S. locales this is `’.’`.
-[^22]: In common U.S. locales this is `’,’`.
-[^23]: To specify grouping by 3s, the value is `"\003"` *not* `"3"`.
-[^24]: For international specializations (second template parameter
     `true`) this is typically four characters long, usually three
     letters and a space.
-[^25]: This is usually the empty string.
-[^26]: In common U.S. locales, this is 2.
-[^27]: Note that the international symbol returned by `do_curr_sym()`
     usually contains a space, itself; for example, `"USD "`.

 ## C library locales <a id="c.locales">[[c.locales]]</a>
+### Header `<clocale>` synopsis <a id="clocale.syn">[[clocale.syn]]</a>
+``` cpp
+namespace std {
+  struct lconv;
+  char* setlocale(int category, const char* locale);
+  lconv* localeconv();
+}
+#define NULL see [support.types.nullptr]
+#define LC_ALL see below
+#define LC_COLLATE see below
+#define LC_CTYPE see below
+#define LC_MONETARY see below
+#define LC_NUMERIC see below
+#define LC_TIME see below
+```
+The contents and meaning of the header `<clocale>` are the same as the C
+standard library header `<locale.h>`.
 Calls to the function `setlocale` may introduce a data race (
 [[res.on.data.races]]) with other calls to `setlocale` or with calls to
 the functions listed in Table  [[tab:setlocale.data.races]].
+ISO C 7.11.
 **Table: Potential `setlocale` data races** <a id="tab:setlocale.data.races">[tab:setlocale.data.races]</a>
 |           |            |             |              |            |
 | --------- | ---------- | ----------- | ------------ | ---------- |
 | `fprintf` | `isprint`  | `iswdigit`  | `localeconv` | `tolower`  |
 | `isdigit` | `iswblank` | `iswupper`  | `strerror`   | `wcstombs` |
 | `isgraph` | `iswcntrl` | `iswxdigit` | `strtod`     | `wcsxfrm`  |
 | `islower` | `iswctype` | `isxdigit`  | `strxfrm`    | `wctomb`   |
 <!-- Link reference definitions -->
 [alg.lex.comparison]: algorithms.md#alg.lex.comparison
 [alg.sort]: algorithms.md#alg.sort
 [algorithms]: algorithms.md#algorithms
+[basic.start.static]: basic.md#basic.start.static
 [bitmask.types]: library.md#bitmask.types
 [c.files]: input.md#c.files
 [c.locales]: #c.locales
 [category.collate]: #category.collate
 [category.ctype]: #category.ctype
 [category.messages]: #category.messages
 [category.monetary]: #category.monetary
 [category.numeric]: #category.numeric
 [category.time]: #category.time
 [classification]: #classification
+[clocale.syn]: #clocale.syn
 [conversions]: #conversions
 [conversions.character]: #conversions.character
 [facet.ctype.char.dtor]: #facet.ctype.char.dtor
 [facet.ctype.char.members]: #facet.ctype.char.members
 [facet.ctype.char.statics]: #facet.ctype.char.statics
 [facet.ctype.char.virtuals]: #facet.ctype.char.virtuals
 [facet.ctype.special]: #facet.ctype.special
 [locale.num.get]: #locale.num.get
 [locale.numpunct]: #locale.numpunct
 [locale.numpunct.byname]: #locale.numpunct.byname
 [locale.operators]: #locale.operators
 [locale.statics]: #locale.statics
 [locale.syn]: #locale.syn
 [locale.time.get]: #locale.time.get
 [locale.time.get.byname]: #locale.time.get.byname
 [locale.time.get.members]: #locale.time.get.members
 [locale.time.get.virtuals]: #locale.time.get.virtuals
 [sequence.reqmts]: containers.md#sequence.reqmts
 [tab:lib.locale.time.get.virtuals.dogetdate]: #tab:lib.locale.time.get.virtuals.dogetdate
 [tab:localization.category.facets]: #tab:localization.category.facets
 [tab:localization.convert.result.values.out.in]: #tab:localization.convert.result.values.out.in
 [tab:localization.convert.result.values.unshift]: #tab:localization.convert.result.values.unshift
 [tab:localization.lib.summary]: #tab:localization.lib.summary
 [tab:localization.required.specializations]: #tab:localization.required.specializations
 [tab:setlocale.data.races]: #tab:setlocale.data.races
 [vector]: containers.md#vector
     that is defined in `<ctime>`.
 [^2]: Note that in the call to `put` the stream is implicitly converted
     to an `ostreambuf_iterator<charT, traits>`.
+[^3]: This is a complete list of requirements; there are no other
+    requirements. Thus, a facet class need not have a public copy
+    constructor, assignment, default constructor, destructor, etc.
+[^4]: When used in a loop, it is faster to cache the `ctype<>` facet and
     use it directly, or use the vector form of `ctype<>::is`.
+[^5]: The char argument of `do_widen` is intended to accept values
     derived from character literals for conversion to the locale’s
     encoding.
+[^6]: In other words, the transformed character is not a member of any
     character classification that `c` is not also a member of.
+[^7]: Only the `char` (not `unsigned char` and `signed char`) form is
     provided. The specialization is specified in the standard, and not
     left as an implementation detail, because it affects the derivation
     interface for `ctype<char>`.
+[^8]: Informally, this means that `basic_filebuf` assumes that the
     mappings from internal to external characters is 1 to N: a `codecvt`
     facet that is used by `basic_filebuf` must be able to translate
     characters one internal character at a time.
+[^9]: Typically these will be characters to return the state to
+    `stateT()`.
+[^10]: If `encoding()` yields `-1`, then more than `max_length()`
+ `externT` elements may be consumed when producing a single `internT`
     character, and additional `externT` elements may appear at the end
     of a sequence after those that yield the final `internT` character.
+[^11]: Parsing `"-1"` correctly into, e.g., an `unsigned short` requires
     that the corresponding member `get()` at least extract the sign
     before delegating.
+[^12]: The conversion specification `#o` generates a leading `0` which
     is *not* a padding character.
+[^13]: Thus, the string `"\003"` specifies groups of 3 digits each, and
     `"3"` probably indicates groups of 51 (!) digits each, because 51 is
     the ASCII value of `"3"`.
+[^14]: This function is useful when one string is being compared to many
     other strings.
+[^15]: In other words, user confirmation is required for reliable
     parsing of user-entered dates and times, but machine-generated
     formats can be parsed reliably. This allows parsers to be aggressive
     about interpreting user variations on standard formats.
+[^16]: This function is intended as a convenience only, for common
     formats, and may return `no_order` in valid locales.
+[^17]: Although the C programming language defines no modifiers, most
     vendors do.
+[^18]: Interpretation of the `modifier` argument is
     implementation-defined, but should follow POSIX conventions.
+[^19]: Implementations are encouraged to refer to other standards such
     as POSIX for these definitions.
+[^20]: The semantics here are different from `ct.narrow`.
+[^21]: An array of `char`, rather than an array of `part`, is specified
     for `pattern::field` purely for efficiency.
+[^22]: In common U.S. locales this is `’.’`.
+[^23]: In common U.S. locales this is `’,’`.
+[^24]: To specify grouping by 3s, the value is `"\003"` *not* `"3"`.
+[^25]: For international specializations (second template parameter
     `true`) this is typically four characters long, usually three
     letters and a space.
+[^26]: This is usually the empty string.
+[^27]: In common U.S. locales, this is 2.
+[^28]: Note that the international symbol returned by `do_curr_sym()`
     usually contains a space, itself; for example, `"USD "`.

Diff to HTML by rtfpessoa