General topics | ||||||||||||||||
Flow control | ||||||||||||||||
Conditional execution statements | ||||||||||||||||
Iteration statements (loops) | ||||||||||||||||
Jump statements | ||||||||||||||||
Functions | ||||||||||||||||
Function declaration | ||||||||||||||||
Lambda function expression | ||||||||||||||||
inline specifier | ||||||||||||||||
Dynamic exception specifications(until C++17*) | ||||||||||||||||
noexcept specifier(C++11) | ||||||||||||||||
Exceptions | ||||||||||||||||
Namespaces | ||||||||||||||||
Types | ||||||||||||||||
Specifiers | ||||||||||||||||
| ||||||||||||||||
Storage duration specifiers | ||||||||||||||||
Initialization | ||||||||||||||||
Expressions | ||||||||||||||||
Alternative representations | ||||||||||||||||
Literals | ||||||||||||||||
Boolean -Integer -Floating-point | ||||||||||||||||
Character -String -nullptr(C++11) | ||||||||||||||||
User-defined(C++11) | ||||||||||||||||
Utilities | ||||||||||||||||
Attributes(C++11) | ||||||||||||||||
Types | ||||||||||||||||
typedef declaration | ||||||||||||||||
Type alias declaration(C++11) | ||||||||||||||||
Casts | ||||||||||||||||
Memory allocation | ||||||||||||||||
Classes | ||||||||||||||||
Class-specific function properties | ||||||||||||||||
| ||||||||||||||||
Special member functions | ||||||||||||||||
Templates | ||||||||||||||||
Miscellaneous | ||||||||||||||||
General | |||||||||||||||||||||||||||||||||||||||||||||||||||
Literals | |||||||||||||||||||||||||||||||||||||||||||||||||||
Operators | |||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||
Conversions | |||||||||||||||||||||||||||||||||||||||||||||||||||
C++ (and C) source code may be written in any non-ASCII 7-bit character set that includes theISO 646:1983 invariant character set. However, several C++ operators and punctuators require characters that are outside of the ISO 646 codeset:{, }, [, ], #, \, ^, |, ~
. To be able to use character encodings where some or all of these symbols do not exist (such as the GermanDIN 66003), C++ defines the following alternatives composed of ISO 646 compatible characters.
Contents |
There are alternative spellings for several operators and other tokens that use non-ISO646 characters. In all respects of the language, each alternative token behaves exactly the same as its primary token, except for its spelling (thestringification operator can make the spelling visible). The two-letter alternative tokens are sometimes called "digraphs". Despite being four-letters long,%:%: is also considered a digraph.
Primary | Alternative |
---|---|
&& | and |
&= | and_eq |
& | bitand |
| | bitor |
~ | compl |
! | not |
!= | not_eq |
|| | or |
|= | or_eq |
^ | xor |
^= | xor_eq |
{ | <% |
} | %> |
[ | <: |
] | :> |
# | %: |
## | %:%: |
The following three-character groups (trigraphs) areparsed before comments and string literals are recognized, and each appearance of a trigraph is replaced by the corresponding primary character:
Primary | Trigraph |
---|---|
{ | ??< |
} | ??> |
[ | ??( |
] | ??) |
# | ??= |
\ | ??/ |
^ | ??' |
| | ??! |
~ | ??- |
Because trigraphs are processed early, a comment such as// Will the next line be executed?????/ will effectively comment out the following line, and the string literal such as"Enter date ??/??/??" is parsed as"Enter date\\??".
The characters& and! are invariant under ISO-646, but alternatives are provided for the tokens that use these characters anyway to accommodate even more restrictive historical charsets.
There is no alternative spelling (such aseq) for the equality operator== because the character= was present in all supported charsets.
The same words are defined in the C programming language in the include file<iso646.h> as macros. Because in C++ these are built into the language, the C++ version of<iso646.h>, as well as<ciso646>, does not define anything. The non-word digraphs (e.g<%), however, are part of the core language and can be used without including any header (otherwise, they would be unusable on any charset that lacks#).
and,and_eq,bitand,bitor,compl,not,not_eq,or,or_eq,xor,xor_eq
The following example demonstrates the use of several alternative tokens.
%:include<iostream> struct X<% compl X()<%%>// destructor X()<%%> X(const X bitand)= delete;// copy constructor// X(X and) = delete; // move constructor bool operator not_eq(const X bitand other)<%return this not_eq bitand other;%>%>; int main(int argc,char* argv<::>)<%// lambda with reference-capture:auto greet=<:bitand:>(constchar* name)<%std::cout<<"Hello "<< name<<" from "<< argv<:0:><<'\n';%>; if(argc>1 and argv<:1:> not_eq nullptr) greet(argv<:1:>);else greet("Anon");%>
Possible output:
Hello Anon from ./a.out
C documentation forAlternative operators and tokens |