ISO/IEC 9899:2024

Information technology — Programming languages — C

This document specifies the form and establishes the interpretation of programs written in the C programming language. It is designed to promote the portability of C programs among a variety of data-processing systems. It is intended for use by implementers and programmers. It specifies: — the representation of C programs; — the syntax and constraints of the C language; — the semantic rules for interpreting C programs; — the representation of input data to be processed by C programs; — the representation of output data produced by C programs; — the restrictions and limits imposed by a conforming implementation of C. This document does not specify: — the mechanism by which C programs are transformed for use by a data-processing system; — the mechanism by which C programs are invoked for use by a data-processing system; — the mechanism by which input data are transformed for use by a C program; — the mechanism by which output data are transformed after being produced by a C program; — the size or complexity of a program and its data that will exceed the capacity of any specific data-processing system or the capacity of a particular processor; — all minimal requirements of a data-processing system that is capable of supporting a conforming implementation. Annex J gives an overview of portability issues that a C program can encounter.

Technologies de l'information — Langages de programmation — C

General Information

• Status: Published
• Publication Date: 30-Oct-2024
• ICS: 35.060 - Languages used in information technology
• Technical Committee: ISO/IEC JTC 1/SC 22 - Programming languages, their environments and system software interfaces
• Drafting Committee: ISO/IEC JTC 1/SC 22 - Programming languages, their environments and system software interfaces
• Current Stage: 6060 - International Standard published
• Start Date: 31-Oct-2024
• Due Date: 31-Oct-2024
• Completion Date: 31-Oct-2024

Relations

• Revises: ISO/IEC 9899:2018 - Information technology — Programming languages — C
• Effective Date: 06-Jun-2022

Standards Content (Sample)

International
Standard
ISO/IEC 9899
Fifth edition
Information technology —
2024-10
Programming languages — C
Technologies de l'information — Langages de programmation — C
Reference number
© ISO/IEC 2024
All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may
be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting on
the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address below
or ISO’s member body in the country of the requester.
ISO copyright office
CP 401 • Ch. de Blandonnet 8
CH-1214 Vernier, Geneva
Phone: [phone]
Email: [e-mail]
Website: www.iso.org
Published in Switzerland
© ISO/IEC 2024 – All rights reserved
ii
Contents
Foreword xii
Introduction xiii
1 Scope 1
2 Normative references 2
3 Terms, definitions, and symbols 3
4 Conformance 9
5 Environment 11
5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5.2 Conceptual models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5.2.1 Translation environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5.2.2 Execution environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
5.3 Environmental considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
5.3.1 Character sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
5.3.2 Multibyte characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5.3.3 Character display semantics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.3.4 Signals and interrupts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.3.5 Environmental limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
6 Language 35
6.1 Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
6.2 Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
6.2.1 Scopes of identifiers, type names, and compound literals . . . . . . . . . . . . 35
6.2.2 Linkages of identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
6.2.3 Name spaces of identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
6.2.4 Storage durations of objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
6.2.5 Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
6.2.6 Representations of types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.2.7 Compatible type and composite type . . . . . . . . . . . . . . . . . . . . . . . 43
6.2.8 Alignment of objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
6.2.9 Encodings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
6.3 Conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
6.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
6.3.2 Arithmetic operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
© ISO/IEC 2024 — All rights reserved
iii
6.3.3 Other operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

6.4 Lexical elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
6.4.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

6.4.2 Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
6.4.3 Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
6.4.4 Universal character names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

6.4.5 Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
6.4.6 String literals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

6.4.7 Punctuators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
6.4.8 Header names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
6.4.9 Preprocessing numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

6.4.10 Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
6.5 Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

6.5.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

6.5.2 Primary expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
6.5.3 Postfix operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
6.5.4 Unary operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.5.5 Cast operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
6.5.6 Multiplicative operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
6.5.7 Additive operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
6.5.8 Bitwise shift operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
6.5.9 Relational operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
6.5.10 Equality operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
6.5.11 Bitwise AND operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
6.5.12 Bitwise exclusive OR operator . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
6.5.13 Bitwise inclusive OR operator . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
6.5.14 Logical AND operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
6.5.15 Logical OR operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
6.5.16 Conditional operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
6.5.17 Assignment operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
6.5.18 Comma operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
6.6 Constant expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6.7 Declarations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
6.7.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
6.7.2 Storage-class specifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
6.7.3 Type specifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
6.7.4 Type qualifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
6.7.5 Function specifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
6.7.6 Alignment specifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
6.7.7 Declarators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
© ISO/IEC 2024 — All rights reserved
iv
6.7.8 Type names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

6.7.9 Type definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

6.7.10 Type inference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

6.7.11 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

6.7.12 Static assertions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

6.7.13 Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

6.8 Statements and blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

6.8.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
6.8.2 Labeled statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
6.8.3 Compound statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
6.8.4 Expression and null statements . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
6.8.5 Selection statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
6.8.6 Iteration statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
6.8.7 Jump statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
6.9 External definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
6.9.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
6.9.2 Function definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
6.9.3 External object definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
6.10 Preprocessing directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
6.10.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
6.10.2 Conditional inclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
6.10.3 Source file inclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
6.10.4 Binary resource inclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
6.10.5 Macro replacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
6.10.6 Line control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
6.10.7 Diagnostic directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
6.10.8 Pragma directive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
6.10.9 Null directive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
6.10.10 Predefined macro names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
6.10.11 Pragma operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
6.11 Future language directions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
6.11.1 Floating types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
6.11.2 Linkages of identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
6.11.3 External names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
6.11.4 Character escape sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
6.11.5 Storage-class specifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
6.11.6 Pragma directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
6.11.7 Predefined macro names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
7 Library 191
© ISO/IEC 2024 — All rights reserved
v
7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

7.1.1 Definitions of terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
7.1.2 Standard headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

7.1.3 Reserved identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
7.1.4 Use of library functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
7.2 Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

7.2.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
7.2.2 Program diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

7.3 Complex arithmetic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
7.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
7.3.2 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

7.3.3 Branch cuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
_ _
7.3.4 TheCX LIMITED RANGE pragma . . . . . . . . . . . . . . . . . . . . . . . . . . 197

7.3.5 Trigonometric functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

7.3.6 Hyperbolic functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
7.3.7 Exponential and logarithmic functions . . . . . . . . . . . . . . . . . . . . . . 200
7.3.8 Power and absolute-value functions . . . . . . . . . . . . . . . . . . . . . . . . 201
7.3.9 Manipulation functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
7.4 Character handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
7.4.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
7.4.2 Character classification functions . . . . . . . . . . . . . . . . . . . . . . . . . . 205
7.4.3 Character case mapping functions . . . . . . . . . . . . . . . . . . . . . . . . . 207
7.5 Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
7.6 Floating-point environment . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
7.6.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
_
7.6.2 TheFENV ACCESS pragma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
_
7.6.3 TheFENV ROUND pragma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
_ _
7.6.4 TheFENV DEC ROUND pragma . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
7.6.5 Floating-point exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
7.6.6 Rounding and other control modes . . . . . . . . . . . . . . . . . . . . . . . . 218
7.6.7 Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
7.7 Characteristics of floating types . . . . . . . . . . . . . . . . . . . . . . . . 223
7.8 Format conversion of integer types . . . . . . . . . . . . . . . . . . . . 224
7.8.1 General . . . . . . . . .
...