識別碼

 

C

編譯器支援

語言

標頭檔

型別支援

程式公用程式

可變引數函式支援

錯誤處理

動態記憶體管理

字串函式庫

演算法

數值

日期與時間公用程式

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規格

符號索引

 

C 語言

基本概念

關鍵字

前處理器

語句

運算式

初始化

宣告

函式

其他

C 語言歷史

技術規格

 

基本概念

註解

ASCII

字元集

轉譯階段

標點符號

識別碼

作用域

生命週期

查找與命名空間

類型

算術類型

物件與對齊

main() 函式

as-if 規則

未定義行為

記憶體模型與資料競爭

 

識別子是一個任意長度的序列，由數字、底線、小寫及大寫拉丁字母組成，以及使用 \u 與 \U 跳脫表示法指定的 Unicode 字元(C99 起)，並屬於 XID_Continue 類別(C23 起)。有效的識別子必須以非數字字元開頭（拉丁字母、底線，或 Unicode 非數字字元(C99 起)(C23 止)，或屬於 XID_Start 類別的 Unicode 字元(C23 起)）。識別子區分大小寫（小寫與大寫字母視為不同）。每個識別子必須符合 Normalization Form C。(C23 起)

原始（未跳脫）Unicode 字元是否允許用於識別子，取決於實作。 char *\U0001f431 = "cat"; // supported char *🐱 = "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	(自 C99 起) (C23 之前)
其對應的 ISO/IEC 10646 (Unicode) 碼位具有 XID_Start 或 XID_Continue 屬性的實作定義字元，可分別出現在識別子的開頭或首字之後。	(C23 起)

識別子可以表示下列類型的實體：

• 物件
• 函式
• 標籤（struct、union 或 列舉）
• 結構或聯集成員
• 列舉常數
• typedef 名稱
• 標籤名稱
• 巨集名稱
• 巨集參數名稱

除巨集名稱或巨集參數名稱外，每個識別子皆有作用域，屬於某個命名空間，並可能具有連結性。同一個識別子在程式的不同位置可表示不同的實體，若實體位於不同的命名空間中，則在同一位置亦可表示不同的實體。

保留識別子

下列識別子為保留的，不得在程式中宣告（如此做會引發未定義行為）：

1. 身為關鍵字的識別子不得用於其他用途。特別是，禁止對與關鍵字相同的識別子進行 #define 或 #undef。
2. 所有以底線開頭的外部識別子。
3. 所有以底線開頭並隨後緊接大寫字母或另一個底線的識別子（這些保留識別子允許程式庫使用大量的後台非外部巨集與函式）。
4. 標準程式庫定義的所有外部識別子（在託管環境中）。這意味著使用者提供的外部名稱不得與任何程式庫名稱相符，即使是宣告與程式庫函式相同的函式也不允許。
5. 聲明為由實作保留，或由標準程式庫未來使用的識別子（見下文）。
6. 聲明為潛在保留並由實作提供的識別子（見下文）。 (C23 起)

所有其他識別子均可自由使用。未保留或非潛在保留(C23 起)的識別子在將程式從一個編譯器與程式庫移植到另一個時，不會有發生意外衝突的疑慮。

註：在 C++ 中，任何位置包含雙底線的識別子在所有地方均被保留；但在 C 中，僅有以雙底線開頭的識別子才被保留。

程式庫中保留及潛在保留的識別子

標準程式庫保留其提供的所有識別子。具有外部連結性的保留識別子（例如每個標準函式的名稱）無論包含哪個標頭檔均被保留。其他保留識別子則是在包含其關聯的任何標頭檔時被保留。

潛在保留識別子旨在供實作及標準的未來修訂版本使用。若潛在保留識別子由實作所提供，則該識別子即被視為保留。 實作僅被允許針對被保留為函式名稱的潛在保留識別子提供外部定義。 未由實作提供的潛在保留識別子則不被保留。使用者可以宣告或定義它們而不引發未定義行為，但此類用法不具可移植性。

(C23 起)

下列識別子為實作保留或潛在保留(C23 起)，以供未來標準程式庫使用。

• 函式名稱，全部皆為潛在保留(C23 起)
  • 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(C23 起) 以及它們的 -f 與 -l 後綴變體，位於 <complex.h> (C99 起)
  • 以 is 或 to 開頭並隨後緊接小寫字母，位於 <ctype.h> 與 <wctype.h>(C95 起)
  • 以 str 或 wcs(C23 起) 開頭並隨後緊接小寫字母，位於 <stdlib.h> 與 <inttypes.h>(C23 起)
  • 以 cr_ 開頭，位於 <math.h> (C23 起)
  • 以 wcs 開頭並隨後緊接小寫字母，位於 <wchar.h> (C95 起)
  • 以 atomic_ 開頭並隨後緊接小寫字母，位於 <stdatomic.h> (C11 起)
  • 以 cnd_、mtx_、thrd_ 或 tss_ 開頭並隨後緊接小寫字母，位於 <threads.h> (C11 起)
• typedef 名稱，全部皆為潛在保留(C23 起)
  • 以 int 或 uint 開頭並以 _t 結尾，位於 <stdint.h> (C99 起)
  • 以 atomic_ 或 memory_ 開頭並隨後緊接小寫字母，位於 <stdatomic.h> (C11 起)
  • 以 cnd_、mtx_、thrd_ 或 tss_ 開頭並隨後緊接小寫字母，位於 <threads.h> (C11 起)
• 巨集名稱
  • 以 E 開頭並隨後緊接數字或大寫字母，位於 <errno.h>
  • 以 FE_ 開頭並隨後緊接大寫字母，位於 <fenv.h> (C99 起)
  • 以 DBL_、DEC32_、DEC64_、DEC128_、DEC_、FLT_ 或 LDBL_ 開頭並隨後緊接大寫字母，位於 <float.h>；這些識別子為潛在保留 (C23 起)
  • 以 INT 或 UINT 開頭並以 _MAX、_MIN、_WIDTH(C23 起) 或 _C 結尾，位於 <stdint.h>；這些識別子為潛在保留(C23 起) (C99 起)
  • 以 PRI 或 SCN 開頭並隨後緊接小寫字母或字母 X，位於 <inttypes.h>；這些識別子為潛在保留(C23 起) (C99 起)
  • 以 LC_ 開頭並隨後緊接大寫字母，位於 <locale.h>
  • 以 FP_ 開頭並隨後緊接大寫字母，位於 <math.h> (C23 起)
  • 以 MATH_ 開頭並隨後緊接大寫字母，位於 <math.h>；這些識別子為潛在保留 (C23 起)
  • 以 SIG 或 SIG_ 開頭並隨後緊接大寫字母，位於 <signal.h>
  • 以 TIME_ 開頭並隨後緊接大寫字母，位於 <time.h> (C11 起)
  • 以 ATOMIC_ 開頭並隨後緊接大寫字母，位於 <stdatomic.h>；這些識別子為潛在保留(C23 起) (C11 起)
• 列舉常數，全部皆為潛在保留(C23 起)
  • 以 memory_order_ 開頭並隨後緊接小寫字母，位於 <stdatomic.h> (C11 起)
  • 以 cnd_、mtx_、thrd_ 或 tss_ 開頭並隨後緊接小寫字母，位於 <threads.h> (C11 起)

建議實作在宣告或定義潛在保留識別子時發出警告，除非： 該宣告是實作所提供之具有外部連結性識別子的非定義宣告，且 宣告中使用的類型與定義中使用的類型相容。

(C23 起)

轉譯限制

儘管對識別子的長度沒有明確限制，早期的編譯器對識別子中有效起始字元的數量有限制，連結器也對具有外部連結性的名稱施加了更嚴格的限制。C 標準要求任何符合標準的實作皆須支援下列至少這些限制：

內部識別子或巨集名稱中 31 個有效的起始字元 外部識別子中 6 個有效的起始字元 單一轉譯單元中 511 個外部識別子 單一區塊中宣告 127 個具有區塊作用域的識別子 單一前置處理轉譯單元中同時定義 1024 個巨集識別子	(直到 C99)
內部識別子或巨集名稱中 63 個有效的起始字元 外部識別子中 31 個有效的起始字元 單一轉譯單元中 4095 個外部識別子 單一區塊中宣告 511 個具有區塊作用域的識別子 單一前置處理轉譯單元中同時定義 4095 個巨集識別子	(自 C99 起)

參考

• C23 標準 (ISO/IEC 9899:2024)

• 5.2.5.2 轉譯限制 (p: TBD)

• 6.4.2 識別子 (p: TBD)

• 6.10.10 預先定義的巨集名稱 (p: TBD)

• 6.11.7 預先定義的巨集名稱 (p: TBD)

• 7.33 未來程式庫方向 (p: TBD)

• K.3.1.2 保留識別子 (p: TBD)

• C17 標準 (ISO/IEC 9899:2018)

• 5.2.4.1 轉譯限制 (p: 19-20)

• 6.4.2 識別子 (p: 43)

• 6.10.8 預先定義的巨集名稱 (p: 127-129)

• 6.11.9 預先定義的巨集名稱 (p: 130)

• 7.31 未來程式庫方向 (p: 332-333)

• K.3.1.2 保留識別子 (p: 425)

• C11 標準 (ISO/IEC 9899:2011)

• 5.2.4.1 轉譯限制 (p: 25-26)

• 6.4.2 識別子 (p: 59-60)

• 6.10.8 預先定義的巨集名稱 (p: 175-176)

• 6.11.9 預先定義的巨集名稱 (p: 179)

• 7.31 未來程式庫方向 (p: 455-457)

• K.3.1.2 保留識別子 (p: 584)

• C99 標準 (ISO/IEC 9899:1999)

• 5.2.4.1 轉譯限制 (p: 20-21)

• 6.4.2 識別子 (p: 51-52)

• 6.10.8 預先定義的巨集名稱 (p: 160-161)

• 6.11.9 預先定義的巨集名稱 (p: 163)

• 7.26 未來程式庫方向 (p: 401-402)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 2.2.4.1 轉譯限制

• 3.1.2 識別子

• 3.8.8 預先定義的巨集名稱

參見

C++ 文件 關於 識別子