api - API 设计中的(开始、结束)与(开始、长度)

Question

我看到在指定一系列索引时使用了两种替代约定，例如

subString(int startIndex, int length);

对比

subString(int startIndex, int endIndex);

就您可以使用它们执行的操作而言，它们显然是等效的，唯一的区别在于您是否指定结束索引或范围的长度。

我假设在所有情况下 startIndex 都包含在内，而 endIndex 不包含。

在定义 API 时，是否有任何令人信服的理由选择其中一种而不是另一种？

Answer 1

我更喜欢 length ，因为它让我少了一个需要在文档中询问/查找的问题。

对于基于 endIndex 的端点 - 这是包含性终点还是排他性终点？

(对于任一变体，都可以询问关于 startIndex 的相同问题，但这将是一个反常的 API，使其具有排他性)。