关于编写通用API库的灵活、简洁与方便性之间的矛盾

今天读《LUA中文教程》第24章作者写关于C API的说道：“API 重点放在了灵活性和简洁性方面，有时候以牺牲方便
实用为代价的。一般的任务可能需要涉及很多个 API 调用，这可能令人烦恼，但是他给

你提供了对细节的全部控制的能力，比如错误处理，缓冲大小，和类似的问题。”

我自己也编一套STM32的api关于kernel和通信方面的，给同事用的。用的很happy。效果不错。

但是看到vxworks中的很多api更加的分散一下，就类似与lua作者说的“重点放在了灵活性和简洁性方面”，这样就可以更好的处理各种各样的情况。坏处就是比较难用。

而我写的api集成度更高一些，但是对错误的处理我也是考虑很为周全的。我的api用起来更好用，但是灵活性不足，就是说某些情况下不太适用。

总而言之，api的设计方法还是由需求（应用场合）决定，并且要考虑到使用者的个人能力。