ZHCU875Z August 2001 – October 2023 SM320F28335-EP
在 C 和汇编代码之间共享 C 头文件
单行：
.cdecls [options ,] " filename "[, " filename2 "[,...]]
多行：
.cdecls [options]
%{
/*---------------------------------------------------------------------------------*/
/* C/C++ code - Typically a list of #includes and a few defines */
/*---------------------------------------------------------------------------------*/
%}
.cdecls 指令允许使用混合汇编和 C/C++ 环境的编程器共享 C 头文件，此头文件包含使用 C 和 汇编代码的声明和原型。任何合法的 C/C++ 都可以在 .cdecls 块中使用，并且 C/C++ 声明会使系统自动生成合适的汇编语言，使用户可以在汇编代码中引用 C/C++ 结构，比如调用函数、分配空间、访问结构成员和使用等效的汇编机制。虽然函数和变量定义会被忽略，但常见的 C/C++ 元素被转换为汇编语言，例如：枚举、（非函数类）宏、函数和变量原型、结构体和联合体。
.cdecls 选项会控制将代码视为 C 代码还是 C++ 代码；以及如何呈现 .cdecls 块和转换后的代码。选项必须用英文逗号分隔；它们可以按任何顺序出现：
| C | 将 .cdecls 块中的代码视为 C 源代码（默认）。 | |
| CPP | 将 .cdecls 块中的代码视为 C++ 源代码。这和 C 选项相反。 | |
| NOLIST | 不要在为包含汇编文件生成的任何列表文件中包含转换后的汇编代码（默认）。 | |
| LIST | 在为包含汇编文件生成的任何列表文件中包含转换后的汇编代码。这和 NOLIST 选项相反。 | |
| NOWARN | 不要在 STDERR 上发出有关在解析 .cdecls 源块时无法转换 C/C++ 构造的警告（默认）。 | |
| WARN | 在 STDERR 上发出有关在解析 .cdecls 源块时无法转换 C/C++ 构造的警告（默认）。这和 NOWARN 选项相反。 |
在单行格式中，选项后跟一个或多个要包含的文件名。文件名和选项用英文逗号分隔。列出的每个文件犹如 #include "filename" 是以多行格式指定。
在多行格式中，.cdecls 后面的行必须包含开始的 .cdecls 块指示符 %{。%{ 之后的所有内容，直到结束块指示符 %}，都被视为 C/C++ 源代码并进行处理。普通汇编器进行处理，然后在结束 %} 后面的行上恢复。
%{ 和 %} 中的文本被传递给 C/C++ 编译器以转换为汇编语言。许多 C 语言语法（包括函数和变量定义以及类函数宏）不受支持，在转换过程中会被忽略。但是，传统上出现在 C 头文件中的所有内容都受支持，包括函数和变量原型、结构体和联合体声明、非类函数宏、枚举和 #defines。
生成的汇编语言包含在汇编文件中的 .cdecls 指令处。如果使用 LIST 选项，则转换后的汇编语句将列印在列表文件中。
由 .cdecls 指令生成的汇编语言的处理方式与 .include 文件类似。因此， .cdecls 指令可以嵌套在被复制或包含的文件中。汇编器将嵌套限制为十级；主机操作系统可能会设置额外的限制。汇编器在复制文件的行号之前加上一个字母代码来标识复制级别。A 表示第一个复制的文件，B 表示第二个复制的文件，以此类推。
.cdecls 指令可以出现在汇编源文件中的任何位置，并且可以在一个文件中多次出现。但是，一个 .cdecls 创建的 C/C++ 环境不会被后面的 .cdecls 继承；每个 .cdecls 的 C/C++ 环境在开始时都是全新的。
有关在 C 头文件中设置和使用 .cdecls 指令的更多信息，请参阅Chapter13。
在此示例中，使用 .cdecls 指令调用 C header.h 文件。
C 头文件：
#define WANT_ID 10
#define NAME "John\n"
extern int a_variable;
extern float cvt_integer(int src);
struct myCstruct { int member_a; float member_b; };
enum status_enum { OK = 1, FAILED = 256, RUNNING = 0 };源文件：
.cdecls C,LIST,"myheader.h"
size: .int $sizeof(myCstruct)
aoffset: .int myCstruct.member_a
boffset: .int myCstruct.member_b
okvalue: .int status_enum.OK
failval: .int status_enum.FAILED
.if $defined(WANT_ID)
id .cstring NAME
.endif列表文件：
1 .cdecls C,LIST,"myheader.h"
A 1 ; ------------------------------------------
A 2 ; Assembly Generated from C/C++ Source Code
A 3 ; =========== MACRO DEFINITIONS ===========
A 4 .define "1",_OPTIMIZE_FOR_SPACE
A 5 .define "1",__ASM_HEADER__
A 6 .define "1",__edg_front_end__
A 7 .define "5001000",__COMPILER_VERSION__
A 8 .define "0",__TI_STRICT_ANSI_MODE__
A 9 .define """14:53:42""",__TIME__
A 10 .define """I""",__TI_COMPILER_VERSION_QUAL__
A 11 .define "unsigned long",__SIZE_T_TYPE__
A 12 .define "long",__PTRDIFF_T_TYPE__
A 13 .define "1",__TMS320C2000__
A 14 .define "1",_TMS320C28X
A 15 .define "1",_TMS320C2000
A 16 .define "1",__TMS320C28X__
A 17 .define "1",__STDC__
A 18 .define "1",__signed_chars__
A 19 .define "0",__GNUC_MINOR__
A 20 .define "1",_TMS320C28XX
A 21 .define "5001000",__TI_COMPILER_VERSION__
A 22 .define "1",__TMS320C28XX__
A 23 .define "1",__little_endian__
A 24 .define "199409L",__STDC_VERSION__
A 25 .define """EDG gcc 3.0 mode""",__VERSION__
A 26 .define """John\n""",NAME
A 27 .define "unsigned int",__WCHAR_T_TYPE__
A 28 .define "1",__TI_RUNTIME_RTS__
A 29 .define "3",__GNUC__
A 30 .define "10",WANT_ID
A 31 .define """Sep 7 2007""",__DATE__
A 32 .define "7250",__TI_COMPILER_VERSION_QUAL_ID__
A 33
A 34 ; =========== TYPE DEFINITIONS ===========
A 35 status_enum .enum
A 36 0001 OK .emember 1
A 37 0100 FAILED .emember 256
A 38 0000 RUNNING .emember 0
A 39 .endenum
A 40
A 41 myCstruct .struct 0,2 ; size=4 bytes|64 bits, align=2
A 42 0000 member_a .field 16 ; int- offset 0, size 1 byte
A 43 0001 .field 16 ; padding
A 44 0002 member_b .field 32 ; float- offset 2 byte,size 2 byte
A 45 0004 .endstruct ; final size=(4 bytes|64 bits)
A 46
A 47 ; =========== EXTERNAL FUNCTIONS ===========
A 48 .global _cvt_integer
A 49
A 50 ; =========== EXTERNAL VARIABLES ===========
A 51 .global _a_variable
2 00000000 0004 size: .int $sizeof(myCstruct)
3 00000001 0000 aoffset: .int myCstruct.member_a
4 00000002 0002 boffset: .int myCstruct.member_b
5 00000003 0001 okvalue: .int status_enum.OK
6 00000004 0100 failval: .int status_enum.FAILED
7 .if $defined(WANT_ID)
8 00000005 004A id .cstring NAME
00000006 006F
00000007 0068
00000008 006E
00000009 000A
0000000a 0000
9 .endif