本仓库 (CatCode-multiplatform) 未来将会合并为 CatCode 主仓库，并删除当前仓库。
猫猫码是一个具有特定格式的字符串格式特殊码，规则为[CAT:xxx,param=value,param=value,...]的格式，其中：
- 以
[开头，]结尾。 - 开头后跟猫猫码的大类型(大小写数字或下划线，标准应为
CAT) - 开大类型后为此码的小类型(大小写数字或下划线)，与大类型之间使用冒号
:分割。 - 参数为多个key不重复的键值对，一对参数使用
=连接键与值，多对参数使用,分割。 - 可以没有参数。
- 区分大小写。
猫猫码将会被作为simpler-robot框架 (即simple-robot的2.x版本) 的送信特殊码使用，以取代曾经的CQ码。
当然，猫猫码也属于一种消息格式，某种程度上猫猫码也可以表示为类似于json等消息类型，但是我不认为他会比json更好用。
但是如果你觉得它很可爱，也欢迎使用~
如果你愿意送给猫猫一颗右上角的星星，猫猫会很开心的喔~
为了避免混淆整个存在猫猫码的文本中不允许出现：[、]、& 字符和制表符与换行符，猫猫码文本内中除了上述字符外，还不允许出现,字符。
因此，猫猫码的转义规则为：
&->&[->[]->],->,\n-> \r-> \t->	
本库提供了丰富地猫猫码解析、封装相关内容。
一切工具类相关的均以Cat开头(或包含)，例如CatDecoder、CatCodeUtil等，
而针对于猫猫码的封装类相关，大部分均以Neko为开头(或包含)命名。例如Neko、Nyanko(FastNeko)、MapNeko。
猫猫码封装接口有Neko（保守猫猫，即参数不可变）、MutableNeko（善变猫猫，可动态变更参数，但是不再基于字符串操作）、EmptyNeko（佛系猫猫，即静态的空参实例）、
以及上述几个类型所各自对应的NoraNeko（野良猫猫，即猫猫码大类型不是CAT但是规则与猫猫码一致的野良猫猫码）
猫猫码工具主要基于字符串操作，减少资源占用与解析封装损耗，效率更高（尤其是在使用不变猫猫的时候）。
任何符合规则：[TYPE:type,param=value,param=value,...]的特殊码均可以视为猫猫码，尽管TYPE并不是CAT。
这类其他类型的“猫猫码”称为WildcatCode(野良猫码), 可以通过WildcatCodeUtil工具来实现对应的解析, 通过NoraNeko实例类型作为封装。
※ 版本可参考上面的版本号小图标
<dependency>
<groupId>love.forte</groupId>
<artifactId>catcode</artifactId>
<version>${version}</version>
</dependency>使用lib/js文件夹下的 kotlin/x.x.x/kotlin.js 与 CatCode.js 文件：
<script src="kotlin.js"></script>
<script src="CatCode.js"></script>使用lib/bin文件夹下对应平台的库文件。
你可以基于标准CAT码格式自行实现。
文档地址：https://www.yuque.com/simpler-robot/catcode
文档尚待建设。
猫猫码存在一些十分常用的类型，这些类型的参数拥有已经约定俗成的参数格式。
text类型是一个基础的类型，其代表了一段不包含cat码的普通文本。
text类型的cat码只有一个参数 text, 其代表了文本的正文内容。
之所以会存在text类型的猫猫码是因为有些场景下可能会需要将一个文本内容表示为一个 Neko 实例。
at类型可以说是十分常见了，其代表 @ 了某个人。
at类型存在几个常见参数：code、all。
code代表其对应被at的用户的账号，是字符串或者数字类型。
例如：[CAT:at,code=1149159218]。
而all代表此CAT是否代表at全体，类型为bool类型。
例如：[CAT:at,all=true]。
当然，也存在使用code=all来代表at全体的效果。
通常来讲，code参数与at参数二者只会存在一个。
image类型代表一个图片类型的消息。
image类型存在几个常见参数：id、file、url、flash。
id一般代表这个图片的一个网络服务器标识。
file一般代表这个图片的本地文件路径，有时候也会作为id参数的代替。
url代表这个图片的网络路径。
flash是bool类型，代表是否作为一个闪照或者可销毁图片。
例如：[CAT:image,id=1,file=1.jpg,flash=true]
通常来讲，file、url两个参数可能同时存在，或至少出现其中一种，而id则根据是否实际存在id值而决定。
voice类型代表一个语音类型的消息。
voice类型存在几个常见参数：id、file、url，其含义与image类型基本一致。
face类型也是一个十分常见的类型，其代表了一个通讯应用中的普通默认表情。
其存在一个 id 参数代表表情的标识。
例如：[CAT:face,id=1]
share类型是一种十分常见的类型，但是它不一定能够被所有平台支持。尽管如此，他依然十分常见。
分享类型一般会存在4种常见参数：title、content、url、image,
其中：
title 代表分享链接的标题。
content 代表分享链接的简述。
url 代表分享的链接。
image 代表分享的链接的封面。
而这其中，url参数是必然存在的。
例如：[CAT:share,url=www.baidu.com,title=百度一下,content=百度一下你就知道]
// get util instance.
final CatCodeUtil catUtil = CatCodeUtil.INSTANCE;
// 构建一个猫猫码 - string
// 例如构建一个字符串类型的: [CAT:at,code=123456,name=forte,age=12]
// 1. StringCodeBuilder
final CodeBuilder<String> stringBuilder = catUtil.getStringCodeBuilder("at");
String catCode1 = stringBuilder
.key("code").value(123456)
.key("name").value("forte")
.key("age").value(12)
.build();
System.out.println(catCode1);
// 构建一个猫猫码 - Neko
// 例如构建一个Neko类型的: [CAT:image,file=1.jpg,dis=true]
// 2. NekoBuilder
final CodeBuilder<Neko> nekoBuilder = catUtil.getNekoBuilder("image");
Neko catCode2 = nekoBuilder
.key("file").value("1.jpg")
.key("dis").value(true)
.build();
System.out.println(catCode2);// NekoObjects中的可获取值均为部分无参数常量，例如at全体。
final Neko alAll = NekoObjects.getNekoAtAll();final String atString = CatCodeUtil.toCat("at", false, "code=123");
final Neko atNeko = CatCodeUtil.toCat("at", false, "code=123"); // 获取CatCode库入口
const cat = CatCode.catcode
const img = cat.CatCodeUtil.toCat({
type: "img",
params: [
{ key: "url", value: "http://baidu.com" },
{ key: "id", value: "a-b-c-d" }
]
})
console.log(img) // 获取CatCode库入口
const cat = CatCode.catcode
const img = cat.CatCodeUtil.toNeko({
type: "img",
params: [
{ key: "url", value: "http://baidu.com" },
{ key: "id", value: "a-b-c-d" }
]
})
console.log(img)
console.log(img.get("url"))注①：kotlin提供的动态库编译结果在调用的时候并不是十分顺手，因此建议通过c/c++编写一个桥梁库（lib-bridge）以简化后续开发，例如官方示例：python_extension
注②：kotlin全平台尚处于alpha阶段，不保证其效率与稳定性。 参考：Kotlin 多平台
// 获取CatCode库入口。kotlin平台通用动态库中只会有一个入口。
CatCode_ExportedSymbols* lib = CatCode_symbols();
// 获取一个字符串数组工具。此工具仅存在于native库中。
CatCode_kref_catcode_ArrayUtil arrayUtil = lib->kotlin.root.catcode.ArrayUtil._instance();
// 构建一个 “字符串数组”
CatCode_kref_kotlin_Array array1 = lib->kotlin.root.catcode.ArrayUtil.array2(arrayUtil, "code=123", "name=forteScarlet");
// 获取CatCodeUtil实例。
CatCode_kref_catcode_CatCodeUtil catCodeUtil = lib->kotlin.root.catcode.CatCodeUtil._instance();
// 调用 CatCodeUtil的 toCat方法获取一个猫猫码字符串实例。
// toCat___是重载定义中的其中一个，参数1为catCodeUtil实例，参数2为猫猫码的类型，参数3为猫猫码的参数列表字符串数组。
const char* atCode = lib->kotlin.root.catcode.CatCodeUtil.toCat___(catCodeUtil, "at", array1);
std::cout << atCode << std::endl;
const char* text = "你好，我是 [CAT:at,code=11111], 你是 [CAT:at,code=222222]";
// 从一串猫猫码字符串中获取对应的参数值信息。
// 参数1 catCodeUtil对象，参数2 存在猫猫码的字符串，参数3 要获取的参数key，参数四 从第几索引位的猫猫码中获取。0为第一位。
const char* code = lib->kotlin.root.catcode.CatCodeUtil.getParam(catCodeUtil, text, "code", 1);
std::cout << "code: " << code << std::endl;
// DisposeString 释放来自于CatCode中的字符串值。
lib->DisposeString(atCode);
lib->DisposeString(code);
// DisposeStablePointer 释放对象
lib->DisposeStablePointer(arrayUtil.pinned);
lib->DisposeStablePointer(array1.pinned);
lib->DisposeStablePointer(catCodeUtil.pinned);
return 0;// 待续...Neko : ねこ(猫)，意为“猫”。
NoraNeko : のらねこ(野良猫)，意为“野猫”。
未来计划通过kotlin发布全平台通用库，可通过JVM/JS/Native操作猫猫码。 代码移植为全平台没问题，native测试执行也没啥问题，但是我不知道怎么发布，所以。。再说吧。
see LICENSE .