TI C2000 Fast Run Time Support Library USER'S GUIDE的错误
在学习TI C2000的快速运行时库的时候发现这文档错误也太多了。而且这玩意的接口文档只有pdf版的,没有html页面的那种。
该文档路径是C2000Ware_4_01_00_00/libraries/math/FPUfastRTS/c28/docs/FASTRTS_SW_LIB_UG.pdf
(时间是2022.6.23,说不定以后改正了)
经常还得在源汇编代码里看,函数接口和函数实现。
问题1:有些函数名不完整
该函数本身应该为:float32_t FS$$DIV (float32_t X, float32_t Y)。
问题2:有些函数的输入范围不完整、输出范围有错误
蓝色圈:文档显示不完整,其应该为[-1, 1],即acos的定义域。
红色圈:文档错误,其应该为[0, π],即acos的值域。
问题3:有部分函数接口文档根本没有内容
红框内的FPU64接口(关于算术和三角的函数),在文档内就在这列了个名字,后面根本没有对其的介绍、讲解。后面只有FID接口的介绍、讲解。
还有些小感悟
这是一个求单精度浮点正弦和余弦的函数。我写的话,一般会用返回一个数组的方法来求结果。但是TI这个函数是用传两个指针参数的方法来记录结果,想了想确实这样要方便点、直观点,毕竟返回数组的函数用起来挺别扭的,使用的人用的时候还要先定义一个数组。而传指针可以做到看见其变量就知道其值的含义是什么,而且还省了数组的操作。