[headers] - C++17 → C++20

Files changed (1) hide show

tmp/tmp4jupcfxm/{from.md → to.md} +32 -75

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

@@ -2,74 +2,56 @@
 Each element of the C++ standard library is declared or defined (as
 appropriate) in a *header*.[^14]
 The C++ standard library provides the *C++ library headers*, shown in
-Table  [[tab:cpp.library.headers]].
-**Table: C++library headers** <a id="tab:cpp.library.headers">[tab:cpp.library.headers]</a>
-|                        |                      |                      |                   |
-| ---------------------- | -------------------- | -------------------- | ----------------- |
-| `<algorithm>`          | `<future>`           | `<numeric>`          | `<strstream>`     |
-| `<any>`                | `<initializer_list>` | `<optional>`         | `<system_error>`  |
-| `<array>`              | `<iomanip>`          | `<ostream>`          | `<thread>`        |
-| `<atomic>`             | `<ios>`              | `<queue>`            | `<tuple>`         |
-| `<bitset>`             | `<iosfwd>`           | `<random>`           | `<type_traits>`   |
-| `<chrono>`             | `<iostream>`         | `<ratio>`            | `<typeindex>`     |
-| `<codecvt>`            | `<istream>`          | `<regex>`            | `<typeinfo>`      |
-| `<complex>`            | `<iterator>`         | `<scoped_allocator>` | `<unordered_map>` |
-| `<condition_variable>` | `<limits>`           | `<set>`              | `<unordered_set>` |
-| `<deque>`              | `<list>`             | `<shared_mutex>`     | `<utility>`       |
-| `<exception>`          | `<locale>`           | `<sstream>`          | `<valarray>`      |
-| `<execution>`          | `<map>`              | `<stack>`            | `<variant>`       |
-| `<filesystem>`         | `<memory>`           | `<stdexcept>`        | `<vector>`        |
-| `<forward_list>`       | `<memory_resource>`  | `<streambuf>`        |                   |
-| `<fstream>`            | `<mutex>`            | `<string>`           |                   |
-| `<functional>`         | `<new>`              | `<string_view>`      |                   |
 The facilities of the C standard library are provided in the additional
-headers shown in Table  [[tab:cpp.c.headers]]. [^15]
-**Table: C++headers for C library facilities** <a id="tab:cpp.c.headers">[tab:cpp.c.headers]</a>
-|              |               |               |             |             |
-| ------------ | ------------- | ------------- | ----------- | ----------- |
-| `<cassert>`  | `<cinttypes>` | `<csignal>`   | `<cstdio>`  | `<cwchar>`  |
-| `<ccomplex>` | `<ciso646>`   | `<cstdalign>` | `<cstdlib>` | `<cwctype>` |
-| `<cctype>`   | `<climits>`   | `<cstdarg>`   | `<cstring>` |             |
-| `<cerrno>`   | `<clocale>`   | `<cstdbool>`  | `<ctgmath>` |             |
-| `<cfenv>`    | `<cmath>`     | `<cstddef>`   | `<ctime>`   |             |
-| `<cfloat>`   | `<csetjmp>`   | `<cstdint>`   | `<cuchar>`  |             |
-Except as noted in Clauses  [[library]] through  [[thread]] and Annex
-[[depr]], the contents of each header `cname` is the same as that of the
-corresponding header `name.h` as specified in the C standard library
-(Clause  [[intro.refs]]). In the C++standard library, however, the
-declarations (except for names which are defined as macros in C) are
-within namespace scope ([[basic.scope.namespace]]) of the namespace
-`std`. It is unspecified whether these names (including any overloads
-added in Clauses  [[language.support]] through  [[thread]] and Annex
-[[depr]]) are first declared within the global namespace scope and are
-then injected into namespace `std` by explicit *using-declaration*s (
-[[namespace.udecl]]).
 Names which are defined as macros in C shall be defined as macros in the
 C++ standard library, even if C grants license for implementation as
 functions.
-[*Note 1*: The names defined as macros in C include the following:
 `assert`, `offsetof`, `setjmp`, `va_arg`, `va_end`, and
 `va_start`. — *end note*]
 Names that are defined as functions in C shall be defined as functions
 in the C++ standard library.[^16]
-Identifiers that are keywords or operators in C++shall not be defined as
-macros in C++standard library headers.[^17]
 [[depr.c.headers]], C standard library headers, describes the effects of
 using the `name.h` (C header) form in a C++ program.[^18]
 Annex K of the C standard describes a large number of functions, with
@@ -80,34 +62,9 @@ service as the C library function with the unsuffixed name, but
 generally take an additional argument whose value is the size of the
 result array. If any C++ header is included, it is
 *implementation-defined* whether any of these names is declared in the
 global namespace. (None of them is declared in namespace `std`.)
-Table  [[tab:c.annex.k.names]] lists the Annex K names that may be
-declared in some header. These names are also subject to the
-restrictions of  [[macro.names]].
-**Table: C standard Annex K names** <a id="tab:c.annex.k.names">[tab:c.annex.k.names]</a>
-|                        |                            |                |               |
-| ---------------------- | -------------------------- | -------------- | ------------- |
-| `abort_handler_s`      | `mbstowcs_s`               | `strncat_s`    | `vswscanf_s`  |
-| `asctime_s`            | `memcpy_s`                 | `strncpy_s`    | `vwprintf_s`  |
-| `bsearch_s`            | `memmove_s`                | `strtok_s`     | `vwscanf_s`   |
-| `constraint_handler_t` | `memset_s`                 | `swprintf_s`   | `wcrtomb_s`   |
-| `ctime_s`              | `printf_s`                 | `swscanf_s`    | `wcscat_s`    |
-| `errno_t`              | `qsort_s`                  | `tmpfile_s`    | `wcscpy_s`    |
-| `fopen_s`              | `RSIZE_MAX`                | `TMP_MAX_S`    | `wcsncat_s`   |
-| `fprintf_s`            | `rsize_t`                  | `tmpnam_s`     | `wcsncpy_s`   |
-| `freopen_s`            | `scanf_s`                  | `vfprintf_s`   | `wcsnlen_s`   |
-| `fscanf_s`             | `set_constraint_handler_s` | `vfscanf_s`    | `wcsrtombs_s` |
-| `fwprintf_s`           | `snprintf_s`               | `vfwprintf_s`  | `wcstok_s`    |
-| `fwscanf_s`            | `snwprintf_s`              | `vfwscanf_s`   | `wcstombs_s`  |
-| `getenv_s`             | `sprintf_s`                | `vprintf_s`    | `wctomb_s`    |
-| `gets_s`               | `sscanf_s`                 | `vscanf_s`     | `wmemcpy_s`   |
-| `gmtime_s`             | `strcat_s`                 | `vsnprintf_s`  | `wmemmove_s`  |
-| `ignore_handler_s`     | `strcpy_s`                 | `vsnwprintf_s` | `wprintf_s`   |
-| `L_tmpnam_s`           | `strerror_s`               | `vsprintf_s`   | `wscanf_s`    |
-| `localtime_s`          | `strerrorlen_s`            | `vsscanf_s`    |               |
-| `mbsrtowcs_s`          | `strlen_s`                 | `vswprintf_s`  |               |

 Each element of the C++ standard library is declared or defined (as
 appropriate) in a *header*.[^14]
 The C++ standard library provides the *C++ library headers*, shown in
+[[headers.cpp]].
 The facilities of the C standard library are provided in the additional
+headers shown in [[headers.cpp.c]]. [^15]
+The headers listed in [[headers.cpp]], or, for a freestanding
+implementation, the subset of such headers that are provided by the
+implementation, are collectively known as the
+*importable C++ library headers*.
+[*Note 1*: Importable C++ library headers can be imported as module
+units [[module.import]]. — *end note*]
+[*Example 1*:
+``` cpp
+import <vector>;                // imports the <vector> header unit
+std::vector<int> vi;            // OK
+```
+— *end example*]
+Except as noted in [[library]] through [[thread]] and [[depr]], the
+contents of each header `cname` is the same as that of the corresponding
+header `name.h` as specified in the C standard library [[intro.refs]].
+In the C++ standard library, however, the declarations (except for names
+which are defined as macros in C) are within namespace scope
+[[basic.scope.namespace]] of the namespace `std`. It is unspecified
+whether these names (including any overloads added in [[support]]
+through [[thread]] and [[depr]]) are first declared within the global
+namespace scope and are then injected into namespace `std` by explicit
+*using-declaration*s [[namespace.udecl]].
 Names which are defined as macros in C shall be defined as macros in the
 C++ standard library, even if C grants license for implementation as
 functions.
+[*Note 2*: The names defined as macros in C include the following:
 `assert`, `offsetof`, `setjmp`, `va_arg`, `va_end`, and
 `va_start`. — *end note*]
 Names that are defined as functions in C shall be defined as functions
 in the C++ standard library.[^16]
+Identifiers that are keywords or operators in C++ shall not be defined
+as macros in C++ standard library headers.[^17]
 [[depr.c.headers]], C standard library headers, describes the effects of
 using the `name.h` (C header) form in a C++ program.[^18]
 Annex K of the C standard describes a large number of functions, with
 generally take an additional argument whose value is the size of the
 result array. If any C++ header is included, it is
 *implementation-defined* whether any of these names is declared in the
 global namespace. (None of them is declared in namespace `std`.)
+[[c.annex.k.names]] lists the Annex K names that may be declared in some
+header. These names are also subject to the restrictions of
+[[macro.names]].

Diff to HTML by rtfpessoa