# rawstr4c
当你需要写一个复杂的C语言字符串的时候,可使用该工具
出于方便,我们仅使用 `just` 来调用
```bash
cd src/recipe
# 尽管我们已经在 recipe 目录中了,但是 just 自己会重新切换到项目根目录,所以我们总是给一个相对根目录的路径
just rawstr4c ./src/recipe/ware
```
## 配置语法
```markdown
- config-item = `value`
- config-item2 = `:mode`
```
配置项总是以 `-` 开头,配置项名称后跟一个 `=`,右值必须使用 ``` `` ``` 来包裹
注意,如果值并非是由用户随意给出,而是只能是默认的几种值之一,则使用 `:` 作为前缀
## 配置项
注意,如非特殊说明,第一项为默认值
- output =
- `:terminal` = 在终端输出
- `:macro` = 输出为一个 `.h` 文件,定义为宏
- `:global-variable` = 输出一个 `.h` 文件和对应的 `.c` 文件,定义为全局变量
- `:global-variable-only-header` = 仅输出为一个 `.h` 文件,定义为全局变量
- output-file =
自定义生成的头文件名,默认值为 `rawstr4c.h`
- translate =
- `:escape` = 仅转义
- `:oct` = 八进制
- `:hex` = 十六进制
- postfix =
- `:use-language` = 使用 code block 的语言
- `scratch string` = 使用某一自定义字符串为后缀
- name =
生成的变量名,默认将会包含前缀和后缀
- name-literally = `false` | `true`
无视其他配置项,直接使用 `name` 作为变量名
- keep-prefix = `true` | `false`
变量名是否使用前缀
- keep-postfix = `true` | `false`
变量名是否使用后缀