c - 为 C 应用程序建模

Question

我想知道是否有任何工具可以帮助我为 C 应用程序建模，即函数式编程。例如，我目前正在构建一个共享库。但是为了直观地传达我的设计，我需要像 UML 这样的东西。我想这样做，这样审查我的设计的人就不需要阅读 100 页的函数、变量等。

我已经阅读了关于 C 的 UML，我正在考虑。如果那里有更好的东西，请告诉我。底线是可视化 C 应用程序和模块的设计，而无需阅读 100 页的文本，因为这需要时间并且对审阅者来说很困难。

这里的专家在这方面的任何帮助将不胜感激。

谢谢。

Answer 1

一个写得很好的文本文档会让你走得更远。远远超过任何 UML 图所能达到的。

Answer 2

你应该把它分成两部分：

• 你想说什么？
• 最好的表达方式是什么？

无论你用什么形式来回答第二部分，你都应该确保它不是模棱两可的。

UML 的好处是语言已经定义了很多语义，因此您不必在协作图中包含这些框、线和箭头的含义的定义。

但最重要的是，记录某些内容意味着为他人理解您正在记录的主题创建一条路径。一个非常精确的描述，不提供如何阅读它的线索，就像没有一样好。因此，使用 UML、有限状态机、ER 图、简单的英语，无论你想要什么，但一定要包含一个逻辑路径，你的“读者”可以遵循以了解正在发生的事情。

我有一个朋友是“不惜一切代价精确”的粉丝，它会要求我们在某种意义出现之前了解所有细节。

我曾经让他做这个实验：下次去一个不知名的城市时，他必须携带他能得到的最精确的地图。更好的是，他必须携带一张 1:1 的城市地图，每一个细节都按比例精确报告。这样他就不会迷路了！

他拒绝了，但我很想看到他尝试使用那张地图。甚至折叠它！:)

Answer 3

随你喜欢。这不是一个标准，但许多开发人员使用它并理解它。如果它确实可以帮助您与其他人交流并记录您的工作 -> 它适合您。如果它只需要太多时间并且你认为它没有效果，那就放弃它。另外，不要在意所有细节，只要它类似于 UML 并且您的团队可以使用它，就可以了。

它旨在帮助您，而不是浪费您的时间。