asm 宣告

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

C++ 語言

通用主題
預處理器 註釋	關鍵詞 轉義序列
流程控制
條件執行語句
if	switch
迭代語句（迴圈）
for range-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++ 歷史

 

宣告

概覽 宣告語法 宣告說明符序列 宣告符 衝突宣告 說明符 typedef inline virtual 函式說明符 explicit 函式說明符 friend constexpr (C++11) consteval (C++20) constinit (C++20) 儲存類說明符 翻譯單元區域性 (C++20) class/struct union enum decltype (C++11) auto (C++11) alignas (C++11) constvolatile 包索引說明符 (C++26)     細化型別說明符 屬性 (C++11)

宣告符 引用 指標 陣列 塊宣告 簡單宣告   →結構化繫結宣告 (C++17) 別名宣告 (C++11) 命名空間別名定義 using 宣告 using 指令 static_assert 宣告 (C++11) asm 宣告 不透明列舉宣告 (C++11) 其他宣告 名稱空間定義 函式宣告 類模板宣告 函式模板宣告 顯式模板例項化 (C++11) 顯式模板特化 連結規範 屬性宣告 (C++11) 空宣告

 

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

語法

attr (可選) asm ( string-literal ) ;		（直到 C++26）
attr (可選) asm ( balanced-token-seq ) ;		(C++26 起)

屬性	-	(自 C++11 起) 任意數量的屬性
string-literal	-	與字串字面量相同，包括原始字串字面量
balanced-token-seq	-	圓括號、方括號和花括號平衡的令牌序列；對 balanced-token-seq 及其含義的任何限制都是實現定義的

解釋

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++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
CWG 195	C++98	要求支援所有 asm 宣告	改為條件支援
CWG 2262	C++11	屬性不能應用於 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 文件，關於 內聯彙編

外部連結

1.	GCC 內聯彙編 HOWTO
2.	GCC 內聯 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 呼叫約定 — 維基百科