c - API 应该假设正确的调用顺序，还是应该验证这些假设？

Question

我有 2 个 api 调用要实现，我们称它们为“ShouldDoSomething”和“DoSomething”。第一个是测试，看看是否需要采取特定操作，而另一个是否实际执行了该操作。自然地，只有在测试返回 true 时才需要采取行动或有效。有些情况下需要测试而不实际采取行动，因此两者都是必要的。

Action 调用是否应该在内部运行测试并在不需要时变成空操作，或者实现是否应该假设它只会在测试已经返回 true 的情况下被调用？验证假设似乎更简单、更安全，但是“操作”调用有 3 种可能的返回状态，而不是两种(成功、失败和不需要)。另一种方法是使测试成为一个断言，并在不必要地调用操作时中止。 (这是在 C 中，所以异常并不是一个好主意)

但这归结为一个选择 - 更简单的 API 调用还是更少的 API 调用？

Answer 1

根据您认为最适合预期用例的策略选择策略。清楚仔细地记录下来。像这样的 API 决策最重要的是文档，而不是选择什么约定的细节。

如果您决定使用第一个选项，您是否真的需要添加一个“不需要”的返回状态，或者如果不需要该操作，它是否可以简单地指示“成功”？除非必要，否则不要增加复杂性。