【ARM64 常见汇编指令学习 20.1 -- ARM 伪指令 .include】

请阅读【嵌入式开发学习必备专栏】

---

ARM 编译指令 .include 使用介绍

在UEFI（统一可扩展固件接口）开发中，通常会用到汇编语言文件（.s 或 .S 文件）。如果你想在一个汇编语言文件中包含（或者说“include”）另一个汇编语言文件，你可以使用 .include 指令。这种方法允许你在一个主汇编文件中引用其他汇编文件中的代码或者数据定义，方便代码的复用和模块化管理。
假设你有两个汇编文件 a.s 和 b.s，并且你想在 a.s 中包含 b.s，你可以在 a.s 中添加 .include "b.s" 指令。

a.s 文件

.global _start
.section .text
_start:
    // 在这里调用 b.s 中定义的函数或者使用其数据
.include "b.s"

b.s 文件

// 定义一些函数或者数据
.section .text
some_function:
    // 函数的实现
    ret

这个例子中，a.s 文件通过 .include "b.s" 指令包含了 b.s。当汇编器处理 a.s 时，它会在遇到 .include 指令的位置插入 b.s 文件的内容。这意味着 b.s 中定义的所有符号（比如 some_function）在 a.s 中都是可见的，就好像这些符号是直接在 a.s 中定义的一样。

小结

• 路径问题：当使用 .include 指令时，你需要确保提供的文件路径是正确的。如果 b.s 位于与 a.s 不同的目录中，你可能需要指定相对路径或绝对路径。
• 文件扩展名：虽然 .s 是汇编文件常用的扩展名，但有些编译环境或汇编器也可能使用 .S。一些编译系统区分大小写，并且把 .S 文件当作预处理汇编文件处理，这意味着 .S 文件中的预处理指令（比如 #include、#define 等）会在汇编前被处理。
• 汇编器差异：不同的汇编器可能支持不同的包含（include）指令或语法。上面的例子使用的是通用的 .include 指令，它在大多数汇编器中都是受支持的。然而，始终建议查阅你所使用的汇编器的文档，以确认正确的语法和功能。