asm 宣告

 

C++

編譯器支援

獨立式與託管式

語言

標準函式庫

標準函式庫標頭檔

具名要求

特性測試巨集 (C++20)

語言支援函式庫

概念函式庫 (C++20)

診斷函式庫

記憶體管理函式庫

元編程函式庫 (C++11)

通用公用程式函式庫

容器函式庫

疊代器函式庫

Ranges 函式庫 (C++20)

演算法函式庫

字串函式庫

文本處理函式庫

數值函式庫

日期與時間函式庫

輸入/輸出函式庫

檔案系統函式庫 (C++17)

並行支援函式庫 (C++11)

執行控制函式庫 (C++26)

技術規範

符號索引

外部函式庫

 

C++ 語言

一般主題
前處理器 註解	關鍵字 轉義序列
流程控制
條件執行陳述式
if	switch
疊代陳述式 (迴圈)
for 範圍 for (C++11)	while do-while
跳躍陳述式
continue - break	goto - return
函式
函式宣告
Lambda 函式運算式
inline 指定符
動態例外規範 (直到 C++17*)
noexcept 指定符 (C++11)
例外
throw 運算式 try 區塊	catch 處理常式
命名空間
命名空間宣告	命名空間別名
型別
基本型別 列舉型別 函式型別	類別/結構型別 共用體型別
指定符
const/volatile decltype (C++11) auto (C++11)	constexpr (C++11) consteval (C++20) constinit (C++20)
儲存期指定符
初始化
預設初始化 值初始化 零初始化 複製初始化 直接初始化	彙總初始化 列表初始化 (C++11)   常數初始化 引用初始化

運算式
數值類別 求值順序	運算子 運算子優先級
替代表示
字面量
布林 - 整數 - 浮點
字元 - 字串 - nullptr (C++11)
使用者定義 (C++11)
公用程式
屬性 (C++11)
型別
typedef 宣告
型別別名宣告 (C++11)
轉型
隱式轉換 static_cast const_cast	顯式轉換 dynamic_cast reinterpret_cast
記憶體分配
new 運算式	delete 運算式
類別
類別宣告 建構子 this 指標	存取指定符 friend 指定符
類別特定函式屬性
虛擬函式 override 指定符 (C++11)   final 指定符 (C++11)	explicit (C++11) static
特殊成員函式
預設建構子 複製建構子 移動建構子 (C++11)	複製賦值 移動賦值 (C++11) 解構子
模板
類別模板 函式模板	模板特化 參數包 (C++11)
其他
內聯組合語言	C++ 歷史

 

宣告

概覽 宣告語法 decl-specifier-seq (宣告說明符序列) 宣告子 (Declarator) 衝突的宣告 指定符 typedef inline virtual 函式說明符 explicit 函式說明符 friend constexpr (C++11) consteval (C++20) constinit (C++20) 儲存類別說明符 翻譯單元局部 (Translation-unit-local) (C++20) class/struct union enum decltype (C++11) auto (C++11) alignas (C++11) constvolatile 封裝包索引說明符 (Pack indexing specifier) (C++26)     詳細型別說明符 (Elaborated type specifier) 屬性 (C++11)

宣告子 參照 (Reference) 指標 (Pointer) 陣列 (Array) 區塊宣告 簡單宣告 (Simple-declaration)   →結構化繫結宣告 (C++17) 別名宣告 (Alias declaration) (C++11) 命名空間別名定義 using 宣告 using 指示 static_assert 宣告 (C++11) asm 宣告 不透明列舉宣告 (Opaque enum declaration) (C++11) 其他宣告 命名空間定義 函式宣告 類別模板宣告 函式模板宣告 顯式模板實例化 (C++11) 顯式模板特化 連結規範 (Linkage specification) 屬性宣告 (Attribute declaration) (C++11) 空宣告

 

asm-宣告 (asm-declaration) 提供了在 C++ 程式中嵌入組合語言原始碼的能力。此宣告是條件支援且(自 C++11 起)由實作定義 (implementation defined)，這意味著它可能不存在，且即使由實作提供，(自 C++11 起)它也沒有固定的含義。

語法

attr (可選) asm ( 字串實字 (string-literal) ) ;		(直到 C++26)
attr (可選) asm ( 平衡權杖序列 (balanced-token-seq) ) ;		（C++26 起）

屬性	-	(C++11 起) 任意數量的 屬性 (attributes)
字串字面值	-	與 字串實字 中的定義相同，包含原始字串實字 (raw string literals)
平衡權杖序列 (balanced-token-seq)	-	一個權杖序列，其中圓括號、方括號和花括號必須平衡；對 平衡權杖序列 的任何限制及其含義均由實作定義

說明

平衡權杖序列 通常是一個字串實字，代表一段以組合語言編寫的短程式，每當執行此宣告時，該程式即會執行。不同的 C++ 編譯器對於 asm-宣告有著截然不同的規則，以及與周圍 C++ 程式碼互動的不同約定。

與其他 區塊宣告 一樣，此宣告可以出現在區塊內（函式主體或其他複合敘述中），且如同所有其他宣告，此宣告也可以出現在區塊之外。

附註

特性測試巨集	數值	標準	功能
__cpp_constexpr	201907L	(C++20)	constexpr 函式中的簡單 預設初始化 與 asm-宣告

關鍵字

asm

範例

示範 GCC/Clang 編譯器提供的兩種內聯組譯語法。此程式僅能在 Linux 下的 x86_64 平台上正確執行。

執行此程式碼

#include <iostream>
 
extern "C" int func(int x);
// the definition of func is written in assembly language
// raw string literal could be very useful
asm(R"(
.globl func
    .type func, @function
    func:
    .cfi_startproc
    movl %edi, %eax /* x is in RDI, see x86-64 calling convention */
    addl $1, %eax
    ret
    .cfi_endproc
)");
 
int main()
{
    int n = func(0110);
    // formerly non-standard inline assembly, made comforming by P2361R6
    asm ("leal (%0,%0,4),%0"
         : "=r" (n)
         : "0" (n));
    std::cout << "73*5 = " << n << std::endl; // flush is intentional
 
    // standard inline assembly
    asm ("movq $60, %rax\n" // the exit syscall number on Linux
         "movq $2,  %rdi\n" // this program returns 2
         "syscall");
}

輸出

73*5 = 365

缺失報告

下列更改行為的缺陷報告追溯應用於之前的 C++ 標準。

DR	應用於	出版時的行為	正確的行為
CWG 195	C++98	要求必須支援所有的 asm 宣告	改為條件支援
CWG 2262	C++11	屬性 (attributes) 無法應用於 asm 宣告	已允許

參考資料

• C++26 標準 (ISO/IEC 14882:2026)

• 9.10 asm 宣告 [dcl.asm]

• C++23 標準 (ISO/IEC 14882:2024)

• 9.10 asm 宣告 [dcl.asm]

• C++20 標準 (ISO/IEC 14882:2020)

• 9.10 asm 宣告 [dcl.asm]

• C++17 標準 (ISO/IEC 14882:2017)

• 10.4 asm 宣告 [dcl.asm]

• C++14 標準 (ISO/IEC 14882:2014)

• 7.4 asm 宣告 [dcl.asm]

• C++11 標準 (ISO/IEC 14882:2011)

• 7.4 asm 宣告 [dcl.asm]

• C++03 標準 (ISO/IEC 14882:2003)

• 7.4 asm 宣告 [dcl.asm]

• C++98 標準 (ISO/IEC 14882:1998)

• 7.4 asm 宣告 [dcl.asm]

參見

• C++ ABI

C 語言文件 關於 內聯組譯 (Inline assembly)

外部連結

1.	GCC Inline Assembly HOWTO
2.	GCC Inline ASM — Locklessinc.com
3.	IBM XL C/C++ 內聯組譯
4.	Intel C++ 內聯組譯
5.	Visual Studio 內聯組譯器
6.	Sun Studio 12 Asm 敘述
7.	基於 Itanium 的 HP-UX 之內聯組譯
8.	X86 呼叫慣例 — 維基百科