アセンブリ言語 - マクロ

マクロ(Macro)はNASMが提供するコード再利用の仕組みであり、コンパイル時にコードテンプレートを展開して、類似コードを繰り返し記述する必要性を減らすことができます。


マクロとは何か

宏(Macro)これはコンパイル時のテキスト置換メカニズムであり、アセンブラのプリプロセッサがコンパイル前に展開します。

プロセス(Procedure)とは異なり、マクロにはCALL/RETのオーバーヘッドがありません——マクロを使用するたびに、コンパイラはマクロの内容を使用位置に直接コピーします。

マクロは関数呼び出しではなく、スタックフレームのオーバーヘッドもありません。ただし、展開のたびにコードがコピーされるため、実行ファイルのサイズは大きくなります。


単行マクロ:%define

%define単一行マクロであり、構文はシンプルです:

实例

; 单行宏示例

; 定义常量
%define MAX_SIZE 256
%define APP_NAME 'サンプル'

; パラメータ付きマクロ(マクロ関数)を定義する
%define mul_by_2(x) (x * 2)
%define sum3(a, b, c) ((a) + (b) + (c))

section .text
    global _start

_start:
    mov eax, MAX_SIZE            ; eax = 256
    mov eax, mul_by_2(10)        ; eax = (10 * 2) = 20
    mov eax, sum3(1, 2, 3)       ; eax = ((1)+(2)+(3)) = 6

    ; 重新定义(%define 可以改变)
    %define MAX_SIZE 512
    mov eax, MAX_SIZE            ; eax = 512

    ; 取消定义
    %undef MAX_SIZE
    ; mov eax, MAX_SIZE          ; 错误:MAX_SIZE 未定义

    mov eax, 1
    mov ebx, 0
    int 0x80

%defineマクロ展開時は純粋なテキスト置換です。例えばmul_by_2(2+3)展開する(2+3 * 2)、演算子の優先順位により、結果は10ではなく8になります。これがマクロの引数に必ず括弧を付ける必要がある理由です。


多行宏:%macro / %endmacro

%macro複数の命令を含む複雑なマクロを定義するために使用します:

实例

; 文件路径:macro_multi.asm
; 多行宏示例

; 宏定义:退出程序
; 参数 argc:宏接受多少个参数
%macro exit_program 1
    mov eax, 1                   ; sys_exit
    mov ebx, %1                  ; 最初のパラメータを終了コードとして使用する
    int 0x80
%endmacro

; 宏定义:打印字符串
; 接受 2 个参数:字符串地址、长度
%macro print_string 2
    push eax
    push ebx
    push ecx
    push edx
    mov eax, 4                   ; sys_write
    mov ebx, 1                   ; stdout
    mov ecx, %1                  ; 字符串地址
    mov edx, %2                  ; 字符串长度
    int 0x80
    pop edx
    pop ecx
    pop ebx
    pop eax
%endmacro

section .data
    msg db 'Hello, サンプル!', 0xA
    msg_len equ $ - msg

section .text
    global _start

_start:
    print_string msg, msg_len     ; 使用宏打印消息
    print_string msg, msg_len     ; 再次调用
    exit_program 0                ; 退出程序

マクロパラメータの高度な使い方

NASMマクロはデフォルト引数、引数カウント、条件付き展開をサポートしています:

实例

; 高级宏参数示例

; デフォルトパラメータを持つマクロ(パラメータ範囲 2-3)
%macro debug_print 2-3 1        ; 至少 2 个参数,最多 3 个,第 3 个默认 = 1
    %if %3 = 1                   ; 如果第 3 个参数 = 1(debug 模式开启)
        push eax
        push ebx
        push ecx
        push edx
        mov eax, 4
        mov ebx, 1
        mov ecx, %1
        mov edx, %2
        int 0x80
        pop edx
        pop ecx
        pop ebx
        pop eax
    %endif
%endmacro

; 可変長引数のマクロ
%macro push_registers 1-*        ; 1 到任意多个参数
    %rep %0                      ; %0 は引数の数
        push %1                  ; 展开第1个
        %rotate 1                ; 向左旋转参数列表
    %endrep
%endmacro

section .text
    global _start

_start:
    ; 使用 push_registers 保存多个寄存器
    push_registers eax, ebx, ecx, edx
    ; 展開:
    ; push eax
    ; push ebx
    ; push ecx
    ; push edx

    ; 対応してポップ
    pop edx
    pop ecx
    pop ebx
    pop eax

    mov eax, 1
    mov ebx, 0
    int 0x80

マクロ内のローカルラベル

宏中使用%%labelローカルラベルを定義して、複数回展開したときのラベル衝突を回避します:

实例

; マクロ内のローカルラベル

; 比较两个值并设置最小值
%macro min_val 2
    mov eax, %1
    mov ebx, %2
    cmp eax, ebx
    jle %%skip                   ; ★ 局部标签,每次展开会生成唯一名
    mov eax, ebx
%%skip:
%endmacro

; ローカルラベルを使用しない場合、2回展開すると重複した skip ラベルが現れる
section .text
    global _start

_start:
    min_val 10, 5               ; eax = 5
    min_val eax, 3              ; eax = 3

    mov eax, 1
    mov ebx, 0
    int 0x80

通常のラベルはマクロ内で2回展開されるとラベル名重複エラーを引き起こします。ローカルラベルは%%labelNASMに展開のたびに一意のラベル名を生成させます(例:..@0001.skip)、衝突を避ける。


マクロとプロシージャの比較

特性宏(Macro)过程(Procedure)
实现方式コンパイル時のテキスト展開実行時のCALL/RET
执行开销呼び出しオーバーヘッドなし(直接インライン展開)CALL/RETのオーバーヘッドがあります(約数クロックサイクル)
代码大小展開のたびにサイズが増加1つのコードを複数回呼び出し
参数类型任意のテキスト(レジスタ、即値、メモリ)运行时值
调试難しい(展開後は痕跡がない)簡単(関数呼び出しスタックがある)
适用场景短く頻繁に呼び出される、型に柔軟性があるコード複雑なロジック、コード量の多い関数

条件编译:%if / %elif / %else / %endif

マクロプリプロセッサは条件付きコンパイルをサポートしており、シンボル定義に応じて異なるコードを生成できます:

实例

; 文件路径:cond_compile.asm
; 条件付きコンパイルの例:デバッグモードとリリースモード

%define DEBUG 1                  ; 1=调试模式, 0=发布模式

section .data
    msg db 'Program running...', 0xA
    msg_len equ $ - msg
    debug_msg db '[DEBUG] Entering function', 0xA
    debug_len equ $ - debug_msg

section .text
    global _start

_start:
    %if DEBUG = 1
        ; 调试模式:输出调试信息
        mov eax, 4
        mov ebx, 1
        mov ecx, debug_msg
        mov edx, debug_len
        int 0x80
    %endif

    ; 正常业务逻辑
    mov eax, 4
    mov ebx, 1
    mov ecx, msg
    mov edx, msg_len
    int 0x80

    mov eax, 1
    mov ebx, 0
    int 0x80

条件付きコンパイルの一般的な使用シーン:

场景示例
调试/发布切换%if DEBUG / %else / %endif
平台适配%ifdef LINUX / %ifdef WINDOWS
功能开关シンボルの存在有無によって機能を制御する

%rep 繰り返しブロック

%rep繰り返しのコードやデータを生成するために使用:

实例

; %rep 重复块示例

section .data
    ; 256 バイトのルックアップテーブルを生成
    ; 0, 1, 4, 9, 16, 25, ...(平方数表)
    %assign i 0
    ; ここでは %rep による平方表の生成は複雑な計算には使えない
    ; 簡単な例:0-9 の ASCII 表を生成する
    digits: db '0', '1', '2', '3', '4', '5', '6', '7', '8', '9'

section .text
    global _start

_start:
    ; %rep でコード内の命令を繰り返す
    mov eax, 0
    %rep 5                      ; 重复 5 次
        inc eax                  ; eax 每次加 1
    %endrep
    ; eax = 5

    mov ebx, eax
    mov eax, 1
    int 0x80

マクロの過度な使用はコードの可読性とデバッグを困難にします。マクロ本体が10行を超える場合は、プロシージャ呼び出しへの変更を検討してください。性能に敏感なホットパスでは、短いマクロのインライン展開が明確な利点をもたらします。

其他扩展