Anidentifier is an arbitrarily long sequence of digits, underscores, lowercase and uppercase Latin letters, and Unicode characters specified using\u and\Uescape notation(since C99), of classXID_Continue(since C23). A valid identifier must begin with a non-digit character (Latin letter, underscore, or Unicode non-digit character(since C99)(until C23), or Unicode character of classXID_Start)(since C23)). Identifiers are case-sensitive (lowercase and uppercase letters are distinct).Every identifier must conform toNormalization Form C.(since C23)
It is implementation-defined if raw (not escaped) Unicode characters are allowed in identifiers:char*\U0001f431="cat";// supportedchar*🐱="cat";// implementation-defined// (e.g. works with Clang, but not GCC prior to version 10)// both are ill formed in C23. Emoji are not XID_Start characters | (since C99) (until C23) |
| Implementation-defined characters whose corresponding code points inISO/IEC 10646 (Unicode) have the XID_Start or XID_Continue property can appear in the beginning or after the first character of an identifier respectively. | (since C23) |
Identifiers can denote the following types of entities:
Every identifier other than macro names or macro parameter names hasscope, belongs to aname space, and may havelinkage. The same identifier can denote different entities at different points in the program, or may denote different entities at the same point if the entities are in different name spaces.
Contents |
The following identifiers arereserved and may not be declared in a program (doing so invokes undefined behavior):
All other identifiers are available. Identifiers that are not reservedor potentially reserved(since C23) can be used with no fear of unexpected collisions when moving programs from one compiler and library to another.
Note: in C++, identifiers with a double underscore anywhere are reserved everywhere; in C, only the ones that begin with a double underscore are reserved.
The standard library reserves every identifier it provides. Reserved identifiers that haveexternal linkage (e.g. name of every standard function) are reserved regardless which header is included. Other reserved identifiers are reserved when any of its associated headers is included.
Potentially reserved identifiers are intended to be used by the implementation and future revision of standard. If a potentially reserved identifier is provided by the implementation, it becomes reserved. Implementations are only allowed to provideexternal definitions of potentially reserved identifiers that are reserved as function names. Potentially reserved identifiers that are not provided by the implementation are not reserved. They can be declared or defined by the user without undefined behavior. However, such usage is not portable. | (since C23) |
Following identifiers are reservedor potentially reserved(since C23) for the implementation or future use by the standard library.
cerf,cerfc,cexp2,cexpm1,clog10,clog1p,clog2,clgamma,ctgamma,csinpi,ccospi,ctanpi,casinpi,cacospi,catanpi,ccompoundn,cpown,cpowr,crootn,crsqrt,cexp10m1,cexp10,cexp2m1,clog10p1,clog2p1,clogp1(since C23) and their -f and -l suffixed variants, in<complex.h>(since C99)is orto followed by a lowercase letter, in<ctype.h> and<wctype.h>(since C95)strorwcs(since C23) followed by a lowercase letter, in<stdlib.h>and<inttypes.h>(since C23)cr_, in<math.h>(since C23)wcs followed by a lowercase letter, in<wchar.h>(since C95)atomic_ followed by a lowercase letter, in<stdatomic.h>(since C11)cnd_,mtx_,thrd_ ortss_ followed by a lowercase letter, in<threads.h>(since C11)int oruint and ending with_t, in<stdint.h>(since C99)atomic_ ormemory_ followed by a lowercase letter, in<stdatomic.h>(since C11)cnd_,mtx_,thrd_ ortss_ followed by a lowercase letter, in<threads.h>(since C11)E followed by a digit or an uppercase letter, in<errno.h>FE_ followed by an uppercase letter, in<fenv.h>(since C99)DBL_,DEC32_,DEC64_,DEC128_,DEC_,FLT_, orLDBL_ followed by an uppercase letter, in<float.h>; these identifiers are potentially reserved(since C23)INT orUINT and ending with_MAX,_MIN,_WIDTH(since C23), or_C, in<stdint.h>; these identifiers are potentially reserved(since C23)(since C99)PRI orSCN followed by lowercase letter or the letterX, in<inttypes.h>; these identifiers are potentially reserved(since C23)(since C99)LC_ followed by an uppercase letter, in<locale.h>FP_ followed by an uppercase letter, in<math.h>(since C23)MATH_ followed by an uppercase letter, in<math.h>; these identifiers are potentially reserved(since C23)SIG orSIG_ followed by an uppercase letter, in<signal.h>TIME_ followed by an uppercase letter, in<time.h>(since C11)ATOMIC_ followed by an uppercase letter, in<stdatomic.h>; these identifiers are potentially reserved(since C23)(since C11)memory_order_ followed by a lowercase letter, in<stdatomic.h>(since C11)cnd_,mtx_,thrd_ ortss_ followed by a lowercase letter, in<threads.h>(since C11)Implementations are recommended to warn when on declaration or definition of potentially reserved identifiers, except when
| (since C23) |
Even though there is no specific limit on the length of identifiers, early compilers had limits on the number of significant initial characters in identifiers and the linkers imposed stricter limits on the names withexternal linkage. C requires that at least the following limits are supported by any standard-compliant implementation:
| (until C99) |
| (since C99) |
C++ documentation forIdentifiers |