C++ syntax


The syntax of C++ is the set of rules defining how a C++ program is written and compiled.
C++ syntax is largely inherited from the syntax of its ancestor language C, and has influenced the syntax of several later languages including but not limited to Java, C#, and Rust.

Basics

Much of C++'s syntax aligns with C syntax, as C++ provides backwards compatibility with C.
The C++ "Hello, World!" program program is as follows:

import std;
int main

Prior to C++23, the "Hello, world!" program used iostreams.

  1. include
using std::cout;
using std::endl;
int main

Identifier

An identifier is the name of an element in the code. There are certain standard naming conventions to follow when selecting names for elements. Identifiers in C++ are case-sensitive.
An identifier can contain:
  • Any Unicode character that is a letter or digit.
  • Currency sign.
  • Connecting punctuation character.
An identifier cannot:
  • Start with a digit.
  • Be equal to a reserved keyword, null literal or Boolean [data type|Boolean] literal.
The identifier nullptr is not a reserved word, but is a global constant that refers to a null pointer literal. Similarly, the words true and false refer to the Boolean values true and false respectively.

Keywords

Keywords

The following words may not be used as identifier names or redefined, of which there are 80.alignas, alignof, asm, auto, bool, break, case, catch, char, char8_t, char16_t, char32_t, class, concept, const, consteval, constexpr, constinit, const_cast, continue, contract_assert, co_await, co_return, co_yield, decltype, default, do, double, dynamic_cast, else, enum, explicit, export, extern, float, for, friend, goto, if, import, inline, int, long, module, mutable, namespace, new, noexcept, operator, private, protected, public, register, reinterpret_cast, requires, return, short, signed, sizeof, static, static_assert, static_cast, struct, switch, template, this, thread_local, throw, try, typedef, typeid, typename, union, unsigned, using, virtual, void, volatile, wchar_t, while
The keyword restrict, though present in C, is not standard in C++, though some compilers may support it. The keyword fortran, a conditionally supported keyword in C which denotes linkage for the Fortran programming language, is conditionally supported in C++.

Reserved words for literal values

The following words refer to literal values used by the language, of which there are 3.true, false, nullptr
C++ also defines 8 global objects :cin, cout, cerr, clog, wcin, wcout, wcerr, wclog

Alternative operator keywords

The following words are reserved keywords, but are used as alternative spellings for operators and tokens that use non-ISO646 characters, of which there are 11.and, and_eq, bitand, bitor, compl, not, not_eq, or, or_eq, xor, xor_eq

Identifiers with special meaning

The following words may be used as identifier names, but bear special meanings in certain contexts, of which there are 4.final, override, pre, post

Preprocessor directives

The following tokens are recognised by the preprocessor in the context of preprocessor directives, of which there are 20.#if, #elif, #else, #endif, #ifdef, #ifndef, #elifdef, #elifndef, #define, #undef, #include, #embed, #line, #error, #warning, #pragma, #__has_include, #__has_cpp_attribute, #__has_embed, defined
The following macros are defined in the C/C++ standard library:NULL NDEBUG assert __COUNTER__

Technical specification keywords

The following keywords are keywords in some C++ technical specifications, but not the main language itself.
The former reflection technical specification proposed the keyword reflexpr, however C++26's finalised reflection instead used a new operator ^^ instead of reflexpr.
The transactional memory technical specification introduces these keywords, of which there are 4.atomic_cancel, atomic_commit, atomic_noexcept, synchronized
The following identifiers with special meaning are introduced, of which there are 2.transaction_safe, transaction_safe_dynamic

Reserved namespaces

The C++ standard reserves the namespaces std and posix. It is undefined behaviour to add declarations or definitions to these namespaces, with the exception of adding template specialisations to symbols in namespace std. The C++ standard further reserves the module names matching std and std.*.

Code blocks

The separators and signify a code block and a new scope. Class members and the body of a method are examples of what can live inside these braces in various contexts.
Inside of method bodies, braces may be used to create new scopes, as follows:

void doSomething

Comments

C++ has two kinds of comments: traditional comments and end-of-line comments.
Traditional comments, also known as block comments, start with /* and end with */, they may span across multiple lines.

/* This is a multi-line comment.
It may occupy more than one line. */

End-of-line comments start with // and extend to the end of the current line.

// This is an end-of-line comment

Documentation comments in the source files are processed by the external Doxygen tool to generate documentation. This type of comment is identical to traditional comments, except it starts with /** and follows conventions defined by the Doxygen tool. Technically, these comments are a special kind of traditional comment and they are not specifically defined in the language specification.

/**
* This is a documentation comment.
*
* @author John Doe
*/

Command-line arguments

Much like in C, the parameters given on a command line are passed to a C++ program with two predefined variables - the count of the command-line arguments in and the individual arguments as character strings in the pointer array. So the command:
myFilt p1 p2 p3
results in something like:
While individual strings are arrays of contiguous characters, there is no guarantee that the strings are stored as a contiguous group.
The name of the program,, may be useful when printing diagnostic messages or for making one binary serve multiple purposes. The individual values of the parameters may be accessed with,, and, as shown in the following program:

import std;
int main

Objects

C++ introduces object-oriented programming features to C. It offers classes, which provide the four features commonly present in OOP languages: abstraction, encapsulation, inheritance, and polymorphism. One distinguishing feature of classes compared to classes in other programming languages is support for deterministic destructors, which in turn provide support for the Resource Acquisition is Initialization concept.

Object storage

As in C, C++ supports four types of memory management: static storage duration objects, thread storage duration objects, automatic storage duration objects, and dynamic storage duration objects.

Static storage duration objects

Static storage duration objects are created before main is entered and destroyed in reverse order of creation after main exits. The exact order of creation is not specified by the standard to allow implementations some freedom in how to organize their implementation. More formally, objects of this type have a lifespan that "shall last for the duration of the program".
Static storage duration objects are initialized in two phases. First, "static initialization" is performed, and only after all static initialization is performed, "dynamic initialization" is performed. In static initialization, all objects are first initialized with zeros; after that, all objects that have a constant initialization phase are initialized with the constant expression. Though it is not specified in the standard, the static initialization phase can be completed at compile time and saved in the data partition of the executable. Dynamic initialization involves all object initialization done via a constructor or function call. The dynamic initialization order is defined as the order of declaration within the compilation unit. No guarantees are provided about the order of initialization between compilation units.

Thread storage duration objects

Variables of this type are very similar to static storage duration objects. The main difference is the creation time is just before thread creation, and destruction is done after the thread has been joined.

Automatic storage duration objects

The most common variable types in C++ are local variables inside a function or block, and temporary variables. The common feature about automatic variables is that they have a lifetime that is limited to the scope of the variable. They are created and potentially initialized at the point of declaration and destroyed in the reverse order of creation when the scope is left. This is implemented by allocation on the stack.
Local variables are created as the point of execution passes the declaration point. If the variable has a constructor or initializer this is used to define the initial state of the object. Local variables are destroyed when the local block or function that they are declared in is closed. C++ destructors for local variables are called at the end of the object lifetime, allowing a discipline for automatic resource management termed RAII, which is widely used in C++.
Member variables are created when the parent object is created. Array members are initialized from 0 to the last member of the array in order. Member variables are destroyed when the parent object is destroyed in the reverse order of creation. i.e. If the parent is an "automatic object" then it will be destroyed when it goes out of scope which triggers the destruction of all its members.
Temporary variables are created as the result of expression evaluation and are destroyed when the statement containing the expression has been fully evaluated.

Dynamic storage duration objects

These objects have a dynamic lifespan and can be created directly with a call to and destroyed explicitly with a call to. C++ also supports malloc and free, from C, but these are not compatible with and. Use of returns an address to the allocated memory. The C++ Core Guidelines advise against using directly for creating dynamic objects in favor of smart pointers through for single ownership and for reference-counted multiple ownership, which were introduced in C++11.

Interoperability

With C

C++ is often considered to be a superset of C but this is not strictly true. Most C code can easily be made to compile correctly in C++ but there are a few differences that cause some valid C code to be invalid or behave differently in C++. For example, C allows implicit conversion from void* to other pointer types but C++ does not. Also, C++ defines many new keywords, such as new and class, which may be used as identifiers in a C program.
Some incompatibilities have been removed by the 1999 revision of the C standard, which now supports C++ features such as line comments and declarations mixed with code. On the other hand, C99 introduced a number of new features that C++ did not support that were incompatible or redundant in C++, such as variable-length arrays, native complex-number types, designated initializers, compound literals, and the restrict keyword. Some of the C99-introduced features were included in the subsequent version of the C++ standard, C++11. However, the C++11 standard introduces new incompatibilities, such as disallowing assignment of a string literal to a character pointer, which remains valid C.
To intermix C and C++ code, any function declaration or definition that is to be called from/used both in C and C++ must be declared with C linkage by placing it within an extern "C" block. Such a function may not rely on features depending on name mangling.

Inline Assembly

Programs developed in C or C++ often utilize inline assembly to take advantage of its low-level functionalities, greater speed, and enhanced control compared to high-level programming languages when optimizing for performance is essential. C++ provides support for embedding assembly language using asm declarations, but the compatibility of inline assembly varies significantly between compilers and architectures. Unlike high-level language features such as Python or Java, assembly code is highly dependent on the underlying processor and compiler implementation.

Variations across compilers

Different C++ compilers implement inline assembly in distinct ways.
  • GCC and Clang: Use the GCC extended inline assembly syntax. Using __asm__ keyword instead of asm when writing code that can be compiled with -ansi and -std options, which allows specifying input/output operands and clobbered registers. This approach is widely adopted, including by Intel and IBM compilers.
  • MSVC : The inline assembler is built into the compiler. Previously supported inline assembly via the __asm keyword, but this support has been removed in 64-bit mode, requiring separate.asm modules instead.
  • TI ARM Clang and Embedded Compilers: Some embedded system compilers, like Texas Instruments' TI Arm Clang, allow inline assembly but impose stricter rules to avoid conflicts with register conventions and calling conventions.

Interoperability between C++ and Assembly

C++ provides two primary methods of integrating ASM code.
1. Standalone assembly files – Assembly code is written separately and linked with C++ code.
2. Inline assembly – Assembly code is embedded within C++ code using compiler-specific extensions.
Example Code for ASM Compatibility
  • When calling an assembly function from C++, use extern "C" to prevent C++ name mangling.

//main.cpp
import std;
extern "C" int add_asm; // Declare the assembly function
int main


  1. asm code using RISC-V architecture
.section.text
.global add_asm
add_asm:
add a0, a0, a1 # Add first argument and second argument, store in a0
ret # Return

  • Global variables in assembly must be declared as extern in C++ and marked .global in assembly.

// main.cpp
import std;
extern "C" int global_var; // Declare global variable from assembly
int main


  1. asm using RISC-V architecture
.section.data
.global global_var
.align 4
global_var:
.word 42 # Define integer value

  • Inline assembly allows embedding ASM directly in C++ using the asm keyword.

//main.cpp
import std;
int main

Encapsulation

Encapsulation is the hiding of information to ensure that data structures and operators are used as intended and to make the usage model more obvious to the developer. C++ provides the ability to define classes and functions as its primary encapsulation mechanisms. Within a class, members can be declared as either public, protected, or private to explicitly enforce encapsulation. A public member of the class is accessible to any function. A private member is accessible only to functions that are members of that class and to functions and classes explicitly granted access permission by the class. A protected member is accessible to members of classes that inherit from the class in addition to the class itself and any friends.
The object-oriented principle ensures the encapsulation of all and only the functions that access the internal representation of a type. C++ supports this principle via member functions and friend functions, but it does not enforce it. Programmers can declare parts or all of the representation of a type to be public, and they are allowed to make public entities not part of the representation of a type. Therefore, C++ supports not just object-oriented programming, but other decomposition paradigms such as modular programming.
It is generally considered good practice to make all data private or protected, and to make public only those functions that are part of a minimal interface for users of the class. This can hide the details of data implementation, allowing the designer to later fundamentally change the implementation without changing the interface in any way.

Inheritance

Inheritance allows one data type to acquire properties of other data types. Inheritance from a base class may be declared as public, protected, or private. This access specifier determines whether unrelated and derived classes can access the inherited public and protected members of the base class. Only public inheritance corresponds to what is usually meant by "inheritance". The other two forms are much less frequently used. If the access specifier is omitted, a "class" inherits privately, while a "struct" inherits publicly. Base classes may be declared as virtual; this is called virtual inheritance. Virtual inheritance ensures that only one instance of a base class exists in the inheritance graph, avoiding some of the ambiguity problems of multiple inheritance.
Multiple inheritance is a C++ feature allowing a class to be derived from more than one base class; this allows for more elaborate inheritance relationships. For example, a "Flying Cat" class can inherit from both "Cat" and "Flying Mammal". Some other languages, such as C# or Java, accomplish something similar by allowing inheritance of multiple interfaces while restricting the number of base classes to one. An interface as in C# and Java can be defined in as a class containing only pure virtual functions, often known as an abstract base class or "ABC". The member functions of such an abstract base class are normally explicitly defined in the derived class, not inherited implicitly. C++ virtual inheritance exhibits an ambiguity resolution feature called dominance.

Operators and operator overloading

C++ provides more than 35 operators, covering basic arithmetic, bit manipulation, indirection, comparisons, logical operations and others. Almost all operators can be overloaded for user-defined types, with a few notable exceptions such as member access and the conditional operator. The rich set of overloadable operators is central to making user-defined types in C++ seem like built-in types.
Overloadable operators are also an essential part of many advanced C++ programming techniques, such as smart pointers. Overloading an operator does not change the precedence of calculations involving the operator, nor does it change the number of operands that the operator uses. Overloaded "&&" and "||" operators lose their short-circuit evaluation property.

Polymorphism

Polymorphism enables one common interface for many implementations, and for objects to act differently under different circumstances.
C++ supports several kinds of static and dynamic polymorphisms, supported by the language features described above. Compile-time polymorphism does not allow for certain run-time decisions, while runtime polymorphism typically incurs a performance penalty.

Dynamic polymorphism

Inheritance

Variable pointers and references to a base class type in C++ can also refer to objects of any derived classes of that type. This allows arrays and other kinds of containers to hold pointers to objects of differing types. This enables dynamic polymorphism, where the referred objects can behave differently, depending on their types.
C++ also provides the dynamic_cast operator, which allows code to safely attempt conversion of an object, via a base reference/pointer, to a more derived type: downcasting. The attempt is necessary as often one does not know which derived type is referenced. dynamic_cast relies on run-time type information, metadata in the program that enables differentiating types and their relationships. If a dynamic_cast to a pointer fails, the result is the nullptr constant, whereas if the destination is a reference, the cast throws an exception. Objects known to be of a certain derived type can be cast to that with static_cast, bypassing RTTI and the safe runtime type-checking of dynamic_cast, so this should be used only if the programmer is very confident the cast is, and will always be, valid.

Virtual member functions

Ordinarily, when a function in a derived class overrides a function in a base class, the function to call is determined by the type of the object. A given function is overridden when there exists no difference in the number or type of parameters between two or more definitions of that function. Hence, at compile time, it may not be possible to determine the type of the object and therefore the correct function to call, given only a base class pointer; the decision is therefore put off until runtime. This is called dynamic dispatch. Virtual member functions or methods allow the most specific implementation of the function to be called, according to the actual run-time type of the object. In C++ implementations, this is commonly done using virtual function tables. If the object type is known, this may be bypassed by prepending a fully qualified class name before the function call, but in general calls to virtual functions are resolved at run time.
In addition to standard member functions, operator overloads and destructors can be virtual. An inexact rule based on practical experience states that if any function in the class is virtual, the destructor should be as well. As the type of an object at its creation is known at compile time, constructors, and by extension copy constructors, cannot be virtual. Nonetheless, a situation may arise where a copy of an object needs to be created when a pointer to a derived object is passed as a pointer to a base object. In such a case, a common solution is to create a clone virtual function that creates and returns a copy of the derived class when called.
A member function can also be made "pure virtual" by appending it with = 0 after the closing parenthesis and before the semicolon. A class containing a pure virtual function is called an abstract class. Objects cannot be created from an abstract class; they can only be derived from. Any derived class inherits the virtual function as pure and must provide a non-pure definition of it before objects of the derived class can be created. A program that attempts to create an object of a class with a pure virtual member function or inherited pure virtual member function is ill-formed.

Static polymorphism

Function overloading allows programs to declare multiple functions having the same name but with different arguments. The functions are distinguished by the number or types of their formal parameters. Thus, the same function name can refer to different functions depending on the context in which it is used. The type returned by the function is not used to distinguish overloaded functions and differing return types would result in a compile-time error message.
When declaring a function, a programmer can specify for one or more parameters a default value. Doing so allows the parameters with defaults to optionally be omitted when the function is called, in which case the default arguments will be used. When a function is called with fewer arguments than there are declared parameters, explicit arguments are matched to parameters in left-to-right order, with any unmatched parameters at the end of the parameter list being assigned their default arguments. In many cases, specifying default arguments in a single function declaration is preferable to providing overloaded function definitions with different numbers of parameters.

Templates

C++ templates enable generic programming. supports function, class, alias, and variable templates. Templates may be parameterized by types, compile-time constants, and other templates. Templates are implemented by instantiation at compile-time. To instantiate a template, compilers substitute specific arguments for a template's parameters to generate a concrete function or class instance. Some substitutions are not possible; these are eliminated by an overload resolution policy described by the phrase "Substitution failure is not an error". Templates are a powerful tool that can be used for generic programming, template metaprogramming, and code optimization, but this power implies a cost. Template use may increase object code size, because each template instantiation produces a copy of the template code: one for each set of template arguments, however, this is the same or smaller amount of code that would be generated if the code were written by hand. This is in contrast to run-time generics seen in other languages where at compile-time the type is erased and a single template body is preserved.
Templates are different from macros: while both of these compile-time language features enable conditional compilation, templates are not restricted to lexical substitution. Templates are aware of the semantics and type system of their companion language, as well as all compile-time type definitions, and can perform high-level operations including programmatic flow control based on evaluation of strictly type-checked parameters. Macros are capable of conditional control over compilation based on predetermined criteria, but cannot instantiate new types, recurse, or perform type evaluation and in effect are limited to pre-compilation text-substitution and text-inclusion/exclusion. In other words, macros can control compilation flow based on pre-defined symbols but cannot, unlike templates, independently instantiate new symbols. Templates are a tool for static polymorphism and generic programming.
In addition, templates are a compile-time mechanism in C++ that is Turing-complete, meaning that any computation expressible by a computer program can be computed, in some form, by a template metaprogram before runtime.
In summary, a template is a compile-time parameterized function or class written without knowledge of the specific arguments used to instantiate it. After instantiation, the resulting code is equivalent to code written specifically for the passed arguments. In this manner, templates provide a way to decouple generic, broadly applicable aspects of functions and classes from specific aspects without sacrificing performance due to abstraction.
Templates in C++ provide a sophisticated mechanism for writing generic, polymorphic code. In particular, through the curiously recurring template pattern, it is possible to implement a form of static polymorphism that closely mimics the syntax for overriding virtual functions. Because C++ templates are type-aware and Turing-complete, they can also be used to let the compiler resolve recursive conditionals and generate substantial programs through template metaprogramming. Contrary to some opinion, template code will not generate a bulk code after compilation with the proper compiler settings.

Lambda expressions

C++ provides support for anonymous functions, also known as lambda expressions, with the following form:

-> Return

Since C++20, the keyword is optional for template parameters of lambda expressions:

-> Return

If the lambda takes no parameters, and no return type or other specifiers are used, the can be omitted; that is,



The return type of a lambda expression can be automatically inferred, if possible; e.g.:

// inferred
-> int // explicit

The list supports the definition of closures. Such lambda expressions are defined in the standard as syntactic sugar for an unnamed function object.

Exception handling

Exception handling is used to communicate the existence of a runtime problem or error from where it was detected to where the issue can be handled. It permits this to be done in a uniform manner and separately from the main code, while detecting all errors. Should an error occur, an exception is thrown, which is then caught by the nearest suitable exception handler. The exception causes the current scope to be exited, and also each outer scope until a suitable handler is found, calling in turn the destructors of any objects in these exited scopes. At the same time, an exception is presented as an object carrying the data about the detected problem.
Some C++ style guides, such as Google's, LLVM's, and Qt's, forbid the usage of exceptions.
The exception-causing code is placed inside a try block. The exceptions are handled in separate catch blocks ; each try block can have multiple exception handlers, as it is visible in the example below.

import std;
using std::exception;
using std::out_of_range;
using std::vector;
int main

It is also possible to raise exceptions purposefully, using the throw keyword; these exceptions are handled in the usual way. In some cases, exceptions cannot be used due to technical reasons. One such example is a critical component of an embedded system, where every operation must be guaranteed to complete within a specified amount of time. This cannot be determined with exceptions as no tools exist to determine the maximum time required for an exception to be handled. Unlike languages like Java, C# and D, which only allows objects that extend Throwable, C++ allows anything, both primitive types and objects, to be thrown and caught. C++ does not have an Error class like those languages, but has an Exception class. In the aforementioned languages, the distinction between Error and Exception is made in that Errors usually represent irrecoverable states, while Exceptions are more acceptable to catch and represent circumstances that are normal to occur throughout the execution of a program.
Unlike signal handling, in which the handling function is called from the point of failure, exception handling exits the current scope before the catch block is entered, which may be located in the current function or any of the previous function calls currently on the stack.

Concepts

Concepts are an extension to the templates feature provided by the C++ programming language. Concepts are named Boolean predicates on template parameters, evaluated at compile time. A concept may be associated with a template, in which case it serves as a constraint: it limits the set of arguments that are accepted as template parameters.
The main uses of concepts are:
  • introducing type-checking to template programming
  • simplified compiler diagnostics for failed template instantiations
  • selecting function template overloads and class template specializations based on type properties
  • constraining automatic type deduction
There are five different places in a function template signature where a constraint can be used :

template
requires Concept2
Concept3 auto myFunction requires Concept5;
Concept1: A type-constraint. This kind replaces class or typename for declaring a type template parameter. When using a concept instead of the former two the type is constraint.Concept2: A requires-clause. Whenever a type-constraint does not work, for example, because the concept takes multiple parameters, a requires-clause can be used to apply more elaborated constraints.Concept3, Concept4: A constrained placeholder type. The same syntax is available for placeholder variable aka. auto variable. C++20 added abbreviated function templates which use auto as a placeholder type in the parameter declaration. A constrained placeholder type allows to put constraints on the automatically deduced return type of a function or a variable.C5: A trailing requires-clause. This form is similar to Concept2 with one notable exception. A trailing requires-clause can be applied to a function in a class template. This allows the function to remain a regular, template-free function, which can be enabled or disabled depending on the functions trailing requires-clause.
The constraint forms Concept1 and Concept2 can be used in all kinds of templates.

Code inclusion

Headers

Traditionally, code inclusion in C++ followed the ways of C, in which code was imported into another file using the preprocessor directive #include, which would copy the contents of the file into the other file.
Traditionally, C++ code would be divided between a header file and a source file. The header file usually contained declarations of symbols while the source file contained the actual implementation, such as function implementations. This separation was often enforced because #includeing code into another file would result in it being reprocessed for each file it was included by, resulting in increased compilation times if the compiler had to reprocess the same source repeatedly.
Headers often also forced the usage of guards or [pragma once|] to prevent a header from potentially being included into a file multiple times.
The C++ standard library remains accessible through headers, however since C++23 it has been made accessible using modules as well. Even with the introduction of modules, headers continue to play a role in modern C++, as existing codebases have not completely migrated to modules.

Header units

Headers are traditionally included via textual inclusion by the preprocessor using #include, while modules are included during compilation through import. However, headers may also be imported using import, even if they are not declared as modules – these are called "header units", and they are designed to allow existing codebases to migrate from headers to modules more gradually. The syntax is similar to including a header, with the difference being that #include is replaced with import and a semicolon is placed at the end of the statement. Header units automatically export all symbols, and differ from proper modules in that they allow the emittance of macros, meaning all who import the header unit will obtain its contained macros. This offers minimal breakage between migration to modules. The semantics of searching for the file depending on whether quotation marks or angle brackets are used apply here as well. For instance, one may write import ; to import the header, or import "MyHeader.h"; to import the file "MyHeader.h" as a header unit. Most build systems, such as CMake, do not support this feature yet.

Binary resource embedding

C++26 adds the #embed preprocessor directive, for binary resource inclusion. The #embed directive can be used to embed binary content into a file, even if it is not valid C++ code.

constexpr char iconDisplayData = ;
// specify any type which can be initialized form integer constant expressions will do
constexpr char resetBlob = ;
// attributes work just as well
alignas constexpr char alignedDataString = ;
int main

Modules

Modules do not use the C preprocessor at all, and are instead handled directly by the compiler. A module is declared using export module, and the beginning of the module preamble begins with module;. Exported symbols which will be made accessible to importing translation units are marked export, and a module is imported into the translation unit using import. Modules do not export macros, due to being handled after the preprocessing step.
Modules may also have partitions, which cannot be imported individually but are owned by a larger module.

Attributes

Since C++11, C++ has supported attribute specifier sequences. Attributes can be applied to any symbol that supports them, including classes, functions/methods, and variables, and any symbol marked with an attribute will be specifically treated by the compiler as necessary. These can be thought of as similar to Java annotations for providing additional information to the compiler, however they differ in that attributes in C++ are not metadata that is meant to be accessed using reflection. C++26 adds support for annotations for reflection. Furthermore, one cannot create custom attributes in C++, unlike in Java where one may define custom annotations in addition to the standard ones. However, C++ does have implementation/vendor-specific attributes which are non-standard. These typically have a namespace associated with them. For instance, GCC and Clang have attributes under the gnu:: namespace, and all such attributes are of the form.
One may apply multiple attributes as a list, for instance . Furthermore, attributes may also accept arguments, like. The following is an example of using some attributes in C++.

class MyObject ;

Standard attributes

The C++ standard defines the following attributes:
Legend:
NameDescription
Indicates that the specified function will not return to its caller.
Indicates that the dependency chain in release-consume std::memory_order propagates in and out of the function. Removed since C++26.

Indicates that the use of the marked symbol is allowed but discouraged/deprecated for the reason specified.
Indicates that the fall through from the previous case label is intentional.
Suppresses compiler warnings on an unused entity.

Issues a compiler warning if the return value of the marked symbol is discarded or ignored for the reason specified.

Indicates that the compiler should optimise for the case where a path of execution through a statement is more or less likely to occur than the other.
Indicates that a non-static data member need not have an address distinct from all other non-static data members of its class.
Indicates that the given expression always evaluates to at a given point, allowing the compiler to make optimisations based on that information.
Indicates that an object bears an indeterminate value if it is not initialised.
Indicates that a function is stateless, effectless, idempotent and independent.
Indicates that a function is effectless and idempotent.

Scoped attributes

As mentioned previously, GCC and Clang have scoped attributes, such as,, and. To apply multiple scoped attributes, one may write:

gnu::always_inline gnu::hot gnu::const nodiscard
inline int f; // declare f with four attributes
gnu::always_inline, gnu::const, gnu::hot, nodiscard
int f; // same as above, but uses a single attr specifier that contains four attributes
// C++17:
using gnu : const, always_inline, hot nodiscard
int fgnu::always_inline; // an attribute may appear in multiple specifiers

Reflection

In addition to basic metaprogramming provided in header , C++26 introduces compile-time reflection. Compile-time reflection capabilities can be accessed in header and declarations are stored in namespace std::meta.

Annotations

Most declarations can have annotations attached, which are just values associated with that declaration. Like Java annotations, annotations can be accessed using reflection. Annotations are different from attributes as attributes are primarily a means to communicate information to the compiler, while annotations are a feature of reflection and allow arbitrary constants and metadata to be attached, making them customisable to programs, unlike attributes. This allows for bridging the communication between the library API and the user.

import std;
using std::string;
using custom::Debug;
using custom::EnumFlag;
using custom::Rename;
enum class =EnumFlag Toggle: uint8_t ;
struct =Debug Person ;

The annotations have no initial meaning unless some implementations use those annotations to identify some characteristics and features.
Creating an annotation to generate a specialisation for std::formatter is as follows:

using std::formatter;
using std::meta::has_annotation;
template
struct Derived ;
template
inline constexpr Derived Derive;
inline constexpr struct Debug;
template
requires
struct formatter ;
struct =Derive Point ;
int main