还在开发中。

现在已经可以使用了

一个歌词的样例见lrc.txt。歌词的格式的初步定义见file_format_define.txt

默认的fparser_platform.c实现中使用了math.h的sinf，因此需要加入-lm的编译选项。这是唯一的非默认的第三方库依赖。您可以自行替换这个函数以避免依赖，或直接加入这个编译选项即可。

歌词支持自定义动画，其中曲线解析部分的源代码位于lex.frp_bison.c frp_bison.tab.c frp_bison.tab.h，这些文件需要使用flex和bison来生成。

如果不修改这几个文件，那么无需安装flex和bison，所需的这些源代码已经上传到git。

完全编译源代码需要安装flex和bison，请在linux系统下生成这些文件。在fedora 30下，使用下面的命令是可行的：

yum install -y flex bison

fparser.c/h仅使用了fparser_platform.c/h和bison、flex生成的文件中的函数，如果希望跨平台，就移植fparser_platform.c/h这个文件。

编写了makefile，执行下面的指令来生成源代码并编译所有的.o目标文件并生成libfparser.a静态库(在obj目录)。

make

程序中有一个test.c是拿来测试的，执行下面的指令可以生成测试程序

make test

或者分别执行

make bin/test.timeline

make bin/test.memcheck

make bin/test.normal

执行下面的指令来进行内存泄漏的测试检查

./memcheck.sh

除了make clean能清除obj文件和其他文件之外，还可以执行make cleanall将bison和flex生成的c文件和h文件一并清除，但下次make需要安装bison和flex才能编译了

直接执行make生成的库文件位于obj目录下，另外需要将include目录下的头文件添加到include路径
假设在这个git的根目录下面构建，不妨使用如下编译选项

-I./include -L./obj -lfparser -lm

TODO，参照test.c，文件的打开、关闭操作、对一个文件进行查询操作不支持多线程，对多个文件分别的查询操作可以是多线程的。

#include "frparser_public.h"
//其它内容
......

//缓冲区
frp_uint8 buff[4096];
//打开文件,文件内容以二进制形式读入buff，这样才能手动处理换行符
FILE * f = fopen(argv[1],"rb");
fread(buff,sizeof(frp_uint8),4096,f);
fclose(f);

//下面两行初始化这个库
//初始化fparser
frpstartup();
//添加对ColorR属性的动画支持
frp_anim_add_support("ColorR");

//解析歌词
FRPFile * f = frpopen(buff,4096,1);

//这里进行frp_play等操作，这期间如果frpopen第三个参数为真，就不要修改buff的值。
//实际上buff的值修改后不会影响歌词解析，这期间除了查询FRPVALUE_TYPE_STR类型的属性的具体值以外是不会去访问buff的。
......


//关闭歌词文件
frpdestroy(f);
//释放全部内存
frpshutdown();

为方便支持utf-8编码，程序内字符串是用frp_uint8 *，即8位无符号类型。 程序内部除部分flex和bison解析外全部使用frp_size数据类型，其定义如下：

typedef struct{
    unsigned int beg;
    frp_size len;
}frp_str;

frp_str表示的是传入frpopen的字符串的子串，文件内部无修改地保留或者拷贝这个字符串于结构体FRPFile的textpool，并当作文字池使用。
beg表示字符串在文字池的起始位置。len表示字符串的字节长度。字符串全部都不是以NULL结尾的。
另外也提供下面的函数用来做字符串处理：

extern int frpstr_cmp(const frp_uint8 * textpool,const frp_str stra,const frp_str strb);
extern int frpstr_rcmp(const frp_uint8 * textpool,const frp_str stra,const frp_uint8 strb[]);
extern int frpstr_rrcmp(const frp_uint8 stra[],const frp_uint8 strb[]);
extern frp_size frpstr_fill(const frp_uint8 * textpool,const frp_str str,frp_uint8 buff[],frp_size size);

其中frpstr_fill将字符串填充到buff和size表示的数组中，并会处理转义符号。

• 如果解析出现warring，则可能内存泄漏
• 如果解析出现Error，则可能内存泄漏

下面是一些文件的作用

此外还有一些文件是用于词法分析器的

一个test.c用于测试