Hexo | 10110

小型二进制写入工具，仅够您使用

安装

cargo install hexo

命令行界面

使用hexo -h获取完整的命令行手册。

参数

• log-level：设置日志级别，可能的值：debug、info、warn、error、none。默认：info。

• safe：启用安全模式，将禁用如cmd和eval等不安全函数。默认：false

命令

build

接受hexo格式的源文件，并编译成二进制文件output

hexo build --source <path to source> --output <path to output>

watch

接受hexo格式的源文件，并编译成二进制文件output。在源文件变更时将重新编译

hexo watch --source <path to source> --output <path to output>

语法

发射器

要发射一个字节，使用符号>后跟字节值

> 0a // by default numbers are interpreted as hexadecimal, will emit decimal 10
> 'HelloWorld' // will emit utf-8 bytes of 'HelloWorld' string
> 10x22 // you can specifiy arbitrary radix in range 2..36, will emit decimal 22

常量

要声明一个常量，使用符号$后跟常量名称和值

$ class_name 'HelloWorld'

然后您可以用它像使用十六进制或二进制字符串一样使用它，只需在前面加上$

> $class_name

声明函数

您可以使用符号#声明任意函数，后跟函数名称和主体

# class_declaration {
  > 0100
  > #len($0)
  > $0
}

函数参数通过它们的索引引用：$0、$1、$2、...

调用函数

要调用一个函数，使用符号#后跟函数名称和参数

// String functions
> #len('HelloWorld') // will emit length of 'HelloWorld' in bytes (0a)

// OS functions
> #cmd(`ls`) // will emit result of command line 'ls' command
> #read_file('file.txt') // will emit content of 'file.txt'

// Padding functions
> #pad_left(AA, 4) // will emit '00 00 00 AA'
> #pad_right(AA, 4) // will emit 'AA 00 00 00'
> #pad('AA', left: 10x4, right: 10x8) // wil pad left by 4 bytes and right by 8 bytes

// Hexo compiler
> #eval('> 01 02 03') // will evaluate passed argument and return resulting compilation

示例

让我们编写'HelloWorld' Java类字节码

$ class_name 'HelloWorld'
$ object_superclass_name 'java/lang/Object'

# class_declaration {
  > 0100
  > #len($0)
  > $0
}

> cafe babe // Magic number

> 0000 0034 // Java Bytecode version
> 0005 // Constant pool size
> 0700 02 // Class at index 2

> #class_declaration($class_name)
> 0700 04 // Class at index 4
> #class_declaration($object_superclass_name)

> 0021 // Supper public
> 0001 0003 // Class pointers
> 0000 0000 0000 0000 // No interfaces, fields, methods, attributes

Q/A

Hexo支持小端吗？

不，Hexo目前只支持大端。但我们目前正在调查支持大端和小端的能力。

我可以将Hexo用作库吗？

目前不可以，但计划在未来的版本中实现。

cmd函数不是非常不安全吗？

是的，安全性不是Hexo的目标，请不要用它运行不受信任的代码。

您可以使用安全模式来禁用 cmd 和 eval 函数。请在命令前添加 --safe 标志以启用它。

为什么默认是安全模式？

由于Hexo是为快速和简单的工作任务设计的，我们决定使其尽可能灵活。因此，默认的安全模式只会使工作流程复杂化，而不会增加任何有意义的价值。