KALDI编码风格

左手的ㄟ右手 2022-04-16 05:57 206阅读 0赞

Kaldi编码风格

当开始编写Kaldi工具包的最终版本时，我们决定使用OpenFst作为C ++库。

为了与OpenFst保持一致，我们决定在大多数方面使用相同的编码风格。

从查看代码可以明显看出Kaldi编码风格的许多方面。要点包括：

*  关于命令命名的规则，例如MyTypeName，MyFunction，my\_class\_member\_var\_，my\_struct\_member，KALDI\_MY\_DEFINE，kGlobalConstant，kEnumMember，g\_my\_global\_variable，my\_namespace，my-file.h，my-file.cc，my-implementation-inl.h
 *  管理函数参数的规则：没有非const引用; 输入先于输出。
 *  管理空格和格式的规则：每行最多80个字符（必要时除外），在函数同一行上打开括号; 查看其他空白约定的代码。
 *  I / O：我们使用C ++样式的I / O，对象的I / O例程有特定的约定（参见[Kaldi I / O机制][Kaldi I _ O]）。
 *  函数参数：我们不允许引用参数为非const（使用指针），iostreams例外。输入必须在函数参数列表中的输出之前。
 *  错误状态主要由异常表示（请参阅[Kaldi日志记录和][Kaldi]特定机制的[错误报告][Kaldi]）。
 *  对于“普通”整数，我们尝试使用int32。这是因为当已知整数类型的二进制大小时，Kaldi的二进制I / O机制（[Kaldi I / O机制][Kaldi I _ O]）最容易使用。
 *  对于“普通”浮点值，我们使用BaseFloat这是一个typedef（如果使用KALDI\_DOUBLEPRECISION = 1进行编译，则为double，否则为float）。这样可以更轻松地以双精度测试算法并检查差异。但是，我们总是使用double作为累加器。
 *  我们在所有\#defines前加上KALDI\_，以避免将来可能与其他代码库发生冲突（因为\#defines不受命名空间保护）。所有kaldi代码都在命名空间kaldi中，除了名称空间为fst的OpenFst扩展。
 *  采用一个参数的类构造函数必须使用“显式”关键字（这可以防止不需要的类型转换）。
 *  我们通常避免使用复制构造函数和赋值运算符（有一个KALDI\_DISALLOW\_COPY\_AND\_ASSIGN可以禁用C ++提供的“默认”）。
 *  我们避免运算符重载，除非STL算法需要。
 *  我们通常避免函数重载，更喜欢不同的名称。
 *  我们使用C ++风格的强制转换，如static\_cast <int>，而不是C风格的强制转换，如（int）
 *  我们尽可能使用const。

Google C ++样式指南的例外情况包括：

*  我们使用iostreams，并允许对iostreams的非const引用传递给函数（这违反了no-non-const-references规则）。
 *  对于get / set方法，假设类成员名为x\_，Google样式的get和set方法将是x（）和set\_x（）。但是，遵循OpenFst编码样式，我们将它们称为X（）和SetX（）：例如，Mean（）和SetMean（）。这个特殊的规则是新的; 在过去，我们有一个不一致的方法，我们将改变代码以符合。

[Kaldi I _ O]: http://www.kaldi-asr.org/doc/io.html
[Kaldi]: http://www.kaldi-asr.org/doc/error.html