AMXXPawn编译器指令#emit

目录

• 1. 简介
• 2. 操作码表格
• 3. 代码示例

1. 简介

#emit指令的作用：

• 插入底层指令：允许开发者绕过高级语法，直接插入 AMX 虚拟机指令，实现更底层的操作。
• 性能优化：没有，因为高级语法被编译后一样会转换为 AMX 虚拟机指令。

该指令只能在函数体内使用。

需要提前了解的概念：

• COD寄存器：储存代码段基址
• CIP寄存器：当前代码段地址偏移量，相对于COD
• DAT寄存器：储存数据段基址
• HEA寄存器：当前插件的堆地址
• FRM寄存器：函数的当前栈地址（教科书称为栈栈，但是错，应该叫栈框或栈区）
• STK寄存器：函数的当前最低栈地址（教科书称为栈顶，但是错错错）
• STP寄存器：函数的当前最高栈地址（教科书称为栈底，但是错错错）
• PRI寄存器：主寄存器（Primary Register）
• ALT寄存器：辅助寄存器（Alternate Register）
• address：绝对地址，不区分地址类型，因为代码段、数据段、堆、栈在同一空间，位置是线性的（代码段→数据段→堆→栈）
• offset：栈的相对地址，frm+offset=绝对地址
• [address]：访问address所指的连续4个字节（取值或赋值）
• {..n}：连续访问左值低位的n个字节，n一般是1、2、4。其它数值触发未定义行为
• 形参：栈变量的一种，通过函数签名声明而得，传值形参储存了实参的值，穿引用形参储存了实参的address
• 实参：调用函数所输入的参数，称为实参，他的值或地址会被复制给形参
• cellsize：等于4，表示amxxpawn脚本中每个数值的字节数。目前amxxpawn只存在32位版本，所以是4字节

#emit指令的语法格式：

#emit 操作码 操作数

• 操作码：必填，不区分大小写，详情点击：操作码大全
• 操作数：由操作码决定是否填写。操作数来源于以下符号：
  正整数——包括二/十/十六进制字面量，将整数值当做操作数。
  浮点数——即浮点数字面量，需#pragma rational开启有理数支持，将浮点数的指针当做操作数。
  常量——const/enum声明的常量，将常量值当做操作数。
  数据段变量——即数组/结构体/字符串字面量，静态/全局变量，将其address当做操作数。
  栈变量——即形参和函数体内用new声明的变量，将其offset当做操作数。
  函数名——将其address当做操作数。必须确保函数声明语句在上。若是native函数，必须在上面被高级语法调用过。
  Label标签——将其address当做操作数。必须确保标签声明语句在上。
• 注意：操作数绝不能是字符、字符串字面量、复合表达式等，例如'1'、"1"、-1、1+5、函数调用。
  若操作数用于跳转，莫填十进制字面量（会被解析为十六进制）

2. 操作码表格

3. 代码示例

修改变量值：

public plugin_init() { // 所有全局/静态变量、字符串/数组/结构体字面量都是数据段变量 static dataV; #emit const.pri 100 // pri=100 #emit stor.pri dataV // [dataV.address]=pri : dataV = 100 server_print("[AMXX]dataV : %d", dataV); // 显示dataV等于100 // 所有形参、局部new变量都是栈变量 new stackV; #emit const.pri 200 // pri=200 #emit stor.s.pri stackV // [frm+stackV.offset]=pri : stackV = 200 server_print("[AMXX]stackV : %d", stackV); // 显示stackV等于200 }

示例2：获取变量地址

public plugin_init() { // 所有全局/静态变量、字符串/数组/结构体字面量都是数据段变量 static dataV; #emit const.pri dataV // pri=dataV.address #emit stor.pri dataV // [dataV.address]=pri // 数据段地址比较靠近0，例如400 server_print("[AMXX]dataV.address : %d == %d", dataV, get_var_addr(dataV)); // 所有形参、局部new变量都是栈变量 new stackV; #emit const.pri stackV // pri=stackV.offset #emit stor.s.pri stackV // [frm+stackV.offset]=pri // 第一个栈变量offset通常是-4，第一个形参offset应该是12 server_print("[AMXX]stackV.offset : %d", stackV); #emit addr.pri stackV // pri=frm+stackV.offset #emit stor.s.pri stackV // [frm+stackV.offset]=pri // 栈地址通常破万，例如17016 server_print("[AMXX]stackV.address : %d == %d", stackV, get_var_addr(stackV)); }

更多内容请参考：AMX Assembly