C23 (C standard revision)
| C language revisions |
|---|
C23, formally ISO/IEC 9899:2024, is the current open standard for the C programming language, which supersedes C17 (standard ISO/IEC 9899:2018).[1] It was started in 2016 informally as C2x,[2] and was published on October 31, 2024.[3] The freely available draft most similar to the one published is document N3220[4] (see Available texts, below). The first WG14 meeting for the C2x draft was held in October 2019,[5] virtual remote meetings were held in 2020 due to the COVID-19 pandemic, then various teleconference meetings continued to occur through 2024.
In C23, the value of __STDC_VERSION__ changes from 201710L to 202311L. The common names "C17" and "C23" reflect these values, which are frozen prior to final adoption, rather than the years in the ISO standards identifiers (9899:2018 and 9899:2024).
Features
[edit ]Changes integrated into the latest working draft of C23 are listed below.[6]
Constants
[edit ]- Add
nullptrconstant fornullptr_ttype.[7] - Add
'digit separator to literal constants,[8] such as0xFE'DC'BA'98(equating to 0xFEDCBA98),299'792'458(equating to 299792458),1.414'213'562(equating to 1.414213562). - Add
0band0Bbinary literal constant prefixes,[9] such as0b10101010(equating to 0xAA), and was previously added in the C++14 standard. This change is similar to earlier established0xand0Xhexadecimal prefixes. - Add
wbanduwbinteger literal suffixes for_BitInt(N)andunsigned_BitInt(N)types,[10] such as6uwbyields anunsigned _BitInt(3), and-6wbyields asigned _BitInt(4)which has three value bits and one sign bit. - Add the ability to specify the underlying type of an
enum.[11] - Allow
enumwith no fixed underlying type to store values that are not representable byint.[12]
Keywords
[edit ]- Add
trueandfalsekeywords.[13] - Add
alignas,alignof,bool,static_assert,thread_localkeywords. Previously defined keywords become alternative spellings:_Alignas,_Alignof,_Bool,_Static_assert,_Thread_local.[14] - Add
_BitIntkeyword (see "types" group). - Add
typeofandtypeof_unqualkeywords (see "types" group). - Add
nullptrkeyword (see "constants" group). - Add
constexprkeyword (see "other" group). - Add
_Decimal32,_Decimal64,_Decimal128keywords for (optional) decimal floating-point arithmetic (see "other" group).
Types
[edit ]- Add
nullptr_t, a null pointer type.[7] - Add
_BitInt(N)andunsigned_BitInt(N)types for bit-precise integers. AddBITINT_MAXWIDTHmacro for maximum bit width.[15] [16] - Add
ckd_add(),ckd_sub(),ckd_mul()macros for checked integer operations.[17] - Variably-modified types (but not VLAs which are automatic variables allocated on the stack) become a mandatory feature.[18]
- Better support for using
constwith arrays.[19] - Standardization of the
typeof(...)operator.[20] - The meaning of the
autokeyword was changed to cause type inference while also retaining its old meaning of a storage class specifier if used alongside a type. Unlike C++, C23 allows type inference only for object definitions (no inferring function return type or function parameter type).[21] - Compatibility rules for structure, union, and enumerated types were changed to allow a redeclaration of a compatible type with the same tag.[22]
- Exact-width integer may now exceed
intmax_t(N2888).[23]
Syntax
[edit ]- Labels can appear before declarations and at the end of compound statements.[24]
- Unnamed parameters in function definitions.[25]
- Zero initialization with
{}(including initialization of VLAs).[26] - Variadic functions no longer need a named argument before the ellipsis and the
va_startmacro no longer needs a second argument nor does it evaluate any argument after the first one if present.[27] - Add C++11 style attribute syntax[28] using double square brackets
[[]]. In addition to C++11 attributes listed below, add new attributes: - Add single-argument
static_assertfor compatibility with C++17.[30] - Functions with no arguments listed in the prototype (e.g.
void foo()) are understood as taking no arguments (see removal of K&R function declarations)
Preprocessor
[edit ]- Add
#elifdefand#elifndefdirectives,[31] which are essentially equivalent to#elif definedand#elif !defined. Both directives were added to C++23 standard and GCC 12.[32] - Add
#embeddirective for binary resource inclusion and__has_embedallowing the availability of a resource to be checked by preprocessor directives.[33] - Add
#warningdirective for diagnostics.[34] - Add
__has_includeallowing the availability of a header to be checked by preprocessor directives.[35] - Add
__has_c_attributeallowing the availability of an attribute to be checked by preprocessor directives.[36] (see "C++ compatibility" group for new attribute feature) - Add
__VA_OPT__functional macro for variadic macros which expands to its argument only if a variadic argument has been passed to the containing macro.[37]
C++ compatibility
[edit ]- Various syntax changes improve compatibility with C++, such as labels before declarations, unnamed function arguments, zero initialization with
{}, variadic functions without named argument, C++11 style attributes,_Static_assert(see Syntax). For labels at the end of compound statements a corresponding change was made to C++23.[38] - Add C++-style attributes (see Syntax). Add attributes[39]
[[deprecated]],[40][[fallthrough]],[41][[maybe_unused]],[42][[nodiscard]],[43] and[[noreturn]]attribute for compatibility with C++11, then deprecate_Noreturn,noreturn, header<stdnoreturn.h>features introduced in C11.[44] Duplicate attributes are allowed for compatibility with C++23.[45] All standard attributes can also be surrounded by double underscores (e.g.[[__deprecated__]]is equivalent to[[deprecated]]). - Add
u8prefix for character literals to represent UTF-8 encoding for compatibility with C++17.[46] [47] - Add
#elifdefand#elifndefpreprocessing directives for compatibility with C++23.[31] (see "preprocessor" group)
Other
[edit ]- Support for the ISO/IEC 60559:2020, the current version of the IEEE 754 standard for floating-point arithmetic, with extended binary floating-point arithmetic and (optional) decimal floating-point arithmetic.[48] [49]
- The
constexprspecifier for objects but not functions, unlike C++'s equivalent.[50] - Add
char8_ttype for storing UTF-8 encoded data and change the type of u8 character constants and string literals tochar8_t. Also, the functionsmbrtoc8()andc8rtomb()to convert a narrow multibyte character to UTF-8 encoding and a single code point from UTF-8 to a narrow multibyte character representation respectively.[51] - Clarify that all
char16_tstrings and literals shall be UTF-16 encoded, and allchar32_tstrings and literals shall be UTF-32 encoded, unless otherwise explicitly specified.[52] - Allow storage class specifiers to appear in compound literal definition.[53]
Standard Library
[edit ]Existing functions
[edit ]- Add
%bbinary conversion specifier toprintf()function family.[54] - Add
%bbinary conversion specifier toscanf()function family.[54] - Add
0band0Bbinary conversion support to functionsstrtol(),strtoll(),strtoul(),strtoull(), and their wide counterpartswcstol(),wcstoll(),wcstoul(),wcstoull(). If a sign is present, the0bor0Bfollows the sign.[54] - Make the functions
bsearch(),bsearch_s(),memchr(),strchr(),strpbrk(),strrchr(),strstr(), and their wide counterpartswmemchr(),wcschr(),wcspbrk(),wcsrchr(),wcsstr()return a const qualified object if one was passed to them.[55]
New functions
[edit ]- Add
memset_explicit()function in<string.h>to erase sensitive data, where memory store must always be performed regardless of optimizations.[56] - Add
memccpy()function in<string.h>to efficiently concatenate strings – similar to POSIX and SVID C extensions.[57] - Add
strdup()andstrndup()functions in<string.h>to allocate a copy of a string – similar to POSIX and SVID C extensions.[58] - Add
memalignment()function in<stdlib.h>to determine the byte alignment of a pointer.[59] - Add bit utility functions / macros / types in new header
<stdbit.h>to examine many integer types. All start withstdc_to minimize conflict with legacy code and 3rd party libraries.[60]- In the following, replace
*withuc,us,ui,ul,ullfor five function names, or blank for a type-generic macro.[60] - Add
stdc_count_ones_*()andstdc_count_zeros_*()to count number of 1 or 0 bits in value.[60] - Add
stdc_leading_ones_*()andstdc_leading_zeros_*()to count leading 1 or 0 bits in value.[60] - Add
stdc_trailing_ones_*()andstdc_trailing_zeros_*()to count trailing 1 or 0 bits in value.[60] - Add
stdc_first_leading_one_*()andstdc_first_leading_zero_*()to find first leading bit with 1 or 0 in value.[60] - Add
stdc_first_trailing_one_*()andstdc_first_trailing_zero_*()to find first trailing bit with 1 or 0 in value.[60] - Add
stdc_has_single_bit_*()to determine if value is an exact power of 2 (return true if and only if there is a single 1 bit).[60] - Add
stdc_bit_floor_*()to determine the largest integral power of 2 that is not greater than value.[60] - Add
stdc_bit_ceil_*()to determine the smallest integral power of 2 that is not less than value.[60] - Add
stdc_bit_width_*()to determine number of bits to represent a value.[60]
- In the following, replace
- Add
timegm()function in<time.h>to convert time structure into calendar time value - similar to function in glibc and musl libraries.[61] - New
<math.h>functions based on IEEE 754-2019 recommendations, such as trigonometry functions operating on units of {\displaystyle \pi x} andexp10.[62]
Obsolete features
[edit ]Obsolete C programming language features removed or deprecated from C23:
- Remove trigraphs.[63]
- Remove K&R function definitions/declarations (with no information about the function arguments).[64] [65]
- Remove representations for signed integers other than two's complement. Two's complement signed integer representation will be required.[66]
- The
*_HAS_SUBNORMmacros in<float.h>are obsolescent features.[67]
Compiler support
[edit ]The following compilers implement an experimental compiler flag to support this standard:
Additionally, versions of GCC beyond GCC 15 now use C23 by default.[71]
Available texts
[edit ]Like other editions of the C standard, the official ISO text of the standard is not freely available.
The latest working draft pre-C23 that was made public was N3096,[6] dated 2023年04月01日. In the months that followed this draft, hundreds of changes[72] were made before producing the working draft N3149 dated 2023年07月09日 and the official draft standard N3219 dated 2024年02月22日.[72] [73] Neither of these later drafts are public.[72] [73]
On the same date that the draft standard N3219 was announced, a new working draft N3220[4] was made public. While this document is officially described[73] as a draft of the future version "C2Y" of the standard, the accompanying "Editor's Report" specifies that N3220 differs from the draft C23 standard N3219 only by a fix to one footnote in Annex K.[73]
See also
[edit ]| C++ language revisions |
|---|
References
[edit ]- ^ "History of C". cppreference.com. 2022年06月27日. Archived from the original on October 19, 2022.
- ^ "WG14-N2086: C2x Charter". open-std.org. 2016年09月20日. Archived from the original on December 22, 2022.
- ^ "ISO/IEC PRF 9899". iso.org. Archived from the original on September 19, 2024. Retrieved March 20, 2024.
- ^ a b "ISO/IEC 9899:2024 (en) — N3220 working draft" (PDF). open-std.org. 2024年02月22日.
- ^ "WG14-N2437: Agenda for October 2019". open-std.org. 2019年10月21日. Archived from the original on March 5, 2021.
- ^ a b "WG14-N3096: Draft for ISO/IEC 9899:2024" (PDF). open-std.org. April 1, 2023. Archived (PDF) from the original on April 2, 2023.
- ^ a b "WR14-N3042: Introduce the nullptr constant". open-std.org. 2022年07月22日. Archived from the original on December 24, 2022.
- ^ "WG14-N2626: Digit separators" (PDF). open-std.org. 2020年12月15日. Archived (PDF) from the original on December 19, 2022.
- ^ "WG14-N2549: Allow for binary integer constants" (PDF). open-std.org. 2020年07月30日. Archived (PDF) from the original on December 22, 2022.
- ^ "WG14-N2775: Literal suffixes for bit-precise integers" (PDF). open-std.org. 2021年07月13日. Archived (PDF) from the original on December 27, 2022.
- ^ "WG14-N3030: Enhancements to Enumerations". open-std.org. 2022年07月19日. Archived from the original on November 26, 2022.
- ^ "WG14-N3029: Improved Normal Enumerations". open-std.org. 2022年07月19日. Archived from the original on January 29, 2023.
- ^ "WG14-N2935: Make false and true first-class language features" (PDF). open-std.org. 2022年02月15日. Archived (PDF) from the original on November 21, 2022.
- ^ "WG14-N2934: Revise spelling of keywords" (PDF). open-std.org. 2022年02月15日. Archived (PDF) from the original on December 24, 2022.
- ^ "WG14-N2763: Adding a Fundamental Type for N-bit integers" (PDF). open-std.org. 2021年06月21日. Archived (PDF) from the original on December 27, 2022.
- ^ "WG14-N3035: _BitInt Fixes" (PDF). open-std.org. 2022年07月21日. Archived (PDF) from the original on October 13, 2022.
- ^ "WG14-N2867: Checked N-Bit Integers" (PDF). open-std.org. 2021年11月28日. Archived (PDF) from the original on December 14, 2022.
- ^ "WG14-N2778: Variably-Modified Types" (PDF). open-std.org. 2021年07月11日. Archived (PDF) from the original on December 22, 2022.
- ^ "WG14-N2607: Compatibility of Pointers to Arrays with Qualifiers" (PDF). open-std.org. 2020年10月31日. Archived (PDF) from the original on October 13, 2022.
- ^ "WG14-N2899: Not-so-magic - typeof for C". open-std.org. 2022年01月21日. Archived from the original on December 24, 2022.
- ^ "WG14-N3007: Type inference for object definitions". open-std.org. 2022年06月10日. Archived from the original on December 24, 2022.
- ^ "WG14-N3037: Improved Rules for Tag Compatibility (updates N3032)" (PDF).
- ^ "C23 is Finished: Here is What is on the Menu". The Pasture. 31 July 2022.
- ^ "WG14-N2508: Free Positioning of Labels Inside Compound Statements" (PDF). open-std.org. 2020年03月28日. Archived (PDF) from the original on December 27, 2022.
- ^ "WG14-N2510: Allowing unnamed parameters in a function definition" (PDF). open-std.org. 2020年04月09日. Archived (PDF) from the original on December 24, 2022.
- ^ "WG14-N2900: Consistent, Warningless, and Intuitive Initialization with {}". open-std.org. 2022年01月01日. Archived from the original on December 27, 2022.
- ^ "WG14-N2975: Relax requirements for variadic parameter lists" (PDF). open-std.org. 2022年04月15日. Archived (PDF) from the original on November 28, 2022.
- ^ "WG14-N2335: Attributes in C" (PDF). open-std.org. 2019年03月09日. Archived (PDF) from the original on October 26, 2022.
- ^ a b "Unsequenced functions". open-std.org. Retrieved 2024年07月18日.
- ^ "WG14-N2265: Harmonizing static_assert with C++" (PDF). open-std.org. 2018年07月06日. Archived (PDF) from the original on March 28, 2023.
- ^ a b "WG14-N2645: Add support for preprocessing directives #elifdef and #elifndef" (PDF). open-std.org. 2020年01月25日. Archived (PDF) from the original on November 28, 2022.
- ^ "GCC 12 Adds Support For New #elifdef #elifndef Directives". phoronix. May 12, 2021. Archived from the original on December 27, 2022.
- ^ "WG14-N3017: #embed - a scannable, tooling-friendly binary resource inclusion mechanism". open-std.org. 2022年06月27日. Archived from the original on December 24, 2022.
- ^ "WG14-N2686: #warning" (PDF). open-std.org. 2022年07月22日. Archived (PDF) from the original on November 28, 2022.
- ^ "WG14-N2799: __has_include for C" (PDF). open-std.org. 2021年08月30日. Archived (PDF) from the original on December 24, 2022.
- ^ "WG14-N2553: Querying attribute support" (PDF). open-std.org. 2020年08月04日. Archived (PDF) from the original on October 14, 2022.
- ^ "WG14-N3033: Comma omission and comma deletion". open-std.org. 2022年07月20日. Archived from the original on December 27, 2022.
- ^ "Labels at the end of compound statements (C compatibility)" (PDF). 2022年01月13日.
- ^ "WG14-N2554: Minor attribute wording cleanups" (PDF). open-std.org. 2020年08月04日. Archived (PDF) from the original on November 28, 2022.
- ^ "WG14-N2334: The deprecated attribute" (PDF). open-std.org. 2019年01月22日. Archived (PDF) from the original on October 19, 2022.
- ^ "WG14-N2408: The fallthrough attribute" (PDF). open-std.org. 2019年08月11日. Archived (PDF) from the original on December 25, 2022.
- ^ "WG14-N2270: The maybe_unused attribute" (PDF). open-std.org. 2018年07月06日. Archived (PDF) from the original on December 25, 2022.
- ^ "WG14-N2267: The nodiscard attribute" (PDF). open-std.org. 2018年07月06日. Archived (PDF) from the original on October 19, 2022.
- ^ "WG14-N2764: The noreturn attribute" (PDF). open-std.org. 2021年06月21日. Archived (PDF) from the original on December 25, 2022.
- ^ "WG14-N2557: Allow Duplicate Attributes" (PDF). open-std.org. 2020年09月01日. Archived (PDF) from the original on November 28, 2022.
- ^ "WG14-N2418: Adding the u8 character prefix" (PDF). open-std.org. 2019年09月02日. Archived (PDF) from the original on January 13, 2023.
- ^ What is the point of the UTF-8 character literals proposed for C++17?; Stack Overflow.
- ^ "WG14-N2341: ISO/IEC TS 18661-2 - Floating-point extensions for C - Part 2: Decimal floating-point arithmetic" (PDF). open-std.org. February 26, 2019. Archived (PDF) from the original on November 21, 2022.
- ^ "WG14-N2601: Annex X - IEC 60559 interchange and extended types" (PDF). open-std.org. October 15, 2020. Archived (PDF) from the original on October 14, 2022.
- ^ "WG14-N3018: The constexpr specifier for object definitions". open-std.org. 2022年07月06日. Archived from the original on December 24, 2022.
- ^ "WG14-N2653: char8_t: A type for UTF-8 characters and strings (Revision 1)". open-std.org. 2021年06月04日. Archived from the original on May 27, 2023.
- ^ "WG14-N2728: char16_t & char32_t string literals shall be UTF-16 & UTF-32". open-std.org. 2021年05月15日. Archived from the original on May 27, 2023.
- ^ "WG14-N3038: Introduce storage-class specifiers for compound literals". open-std.org. 2022年07月21日. Archived from the original on November 26, 2022.
- ^ a b c "WG14-N2630: formatted input/output of binary integer numbers" (PDF). open-std.org. 2021年01月01日. Archived (PDF) from the original on December 14, 2022.
- ^ "WG14-N3020: Qualifier-preserving standard library functions" (PDF). open-std.org. 2022年06月13日. Archived (PDF) from the original on October 13, 2022.
- ^ "WG14-N2897: memset_explicit()". open-std.org. 2021年12月27日. Archived from the original on October 25, 2022.
- ^ "WG14-N2349: Toward more efficient string copying and concatenation". open-std.org. 2019年03月18日. Archived from the original on September 30, 2022.
- ^ "WG14-N2353: strdup() and strndup()". open-std.org. 2019年03月18日. Archived from the original on December 24, 2022.
- ^ "WG14-N2974: Queryable pointer alignment" (PDF). open-std.org. 2022年04月15日. Archived (PDF) from the original on October 13, 2022.
- ^ a b c d e f g h i j k "WG14-N3022: Modern Bit Utilities". open-std.org. 2022年07月06日. Archived from the original on December 24, 2022.
- ^ "WG14-N2833: Add timegm() as non-optional part of time.h". open-std.org. 2021年10月07日. Archived from the original on December 1, 2021.
- ^ See N3096 § B.11 for a useful overview. The functions were added in separate documents: N2488, its updated versions, and its refs.
- ^ "WG14-N2940: Removing trigraphs??!" (PDF). open-std.org. 2022年03月02日. Archived (PDF) from the original on October 26, 2022.
- ^ "WG14-N2432: Remove support for function definitions with identifier lists proposal" (PDF). open-std.org. September 25, 2019. Archived (PDF) from the original on December 27, 2022.
- ^ "WG14-N2841: No function declarators without prototypes". open-std.org. 2021年10月10日. Archived from the original on November 12, 2022.
- ^ "WG14-N2412: Two's complement sign representation" (PDF). open-std.org. August 11, 2019. Archived (PDF) from the original on December 27, 2022.
- ^ "WG14-N2993: Make *_HAS_SUBNORM be obsolescent". open-std.org. 2022年06月06日. Archived from the original on December 5, 2022.
- ^ "GCC 9 Release Notes". GNU Project. Archived from the original on December 27, 2022.
- ^ "Clang 9.0 - add new language mode for C2x". LLVM Project Repository. May 14, 2019. Archived from the original on December 27, 2022.
- ^ "Pelles C - major changes between 10.00 and 11.00". smorgasbordet.com. Archived from the original on December 27, 2022.
- ^ "GCC 15 Release Series". GNU Project. Retrieved 13 July 2025.
- ^ a b c "N3150 - Editor's Report, Post January-February 2023 Meeting". open-std.org. 2023年07月08日.
- ^ a b c d "N3221 - Editor's Report, Post January 2024 Meeting". open-std.org. 2024年02月15日.
Further reading
[edit ]- ISO/IEC 9899:2024 (official C23 standard); ISO; 2024. (available but not free)
- N3096 (last freely-available working draft before C23); WG14; April 2023. (free download)
- N3149 (working draft of C23 standard); WG14; July 2023. (not available to public)
- N3219 (ISO/IEC 9899:2023 DIS Draft); WG14; February 2024. (ISO draft available but not free)
- N3220 (first working draft after C23; differs from draft standard N3219 only in one footnote); WG14; February 2024. (free download)
External links
[edit ]- WG14 Document Repository
- WG14 Meetings - agenda and minutes
- WG14 Charters: C2x Charter, C23 Charter, Interpreting the C23 Charter, C Standard Charter