知识卡片

普通读书笔记卡 · 1915.a.1.b

边界名应表达端点约定

理解等级:中级

边界参数应让读者知道值是否包含在允许范围中。min/max适合包含的上下限,first/last常表达两端包含,begin/end常表达起点含、终点不含。它们是帮助共享约定的名字,具体接口仍须清楚说明。购物车允许最多10件时,数量大于10才超限;含糊的limit容易使比较符号错一位。

first/last用于包含两端的范围,强调最后一项仍是范围成员;start/stop若没有既有约定,读者可能对终点包含性猜测。

begin/end常用于起点包含、终点排除,例如用次日零点表示一天的结束边界,避免写“当天最后一个极小时间点”。end本身仍有歧义,名称约定需与实际契约一致。

半开区间相邻端点相等时不算重叠。区间判断还应明确是否允许空区间或倒置端点,仅注明终点不包含不足以证明所有输入的实现正确。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 4 处

    • · 查看原书依据

      max_或者min_。 在本例中,名字应当是MAX_ITEMS_IN_CART,新代码现在变得简单又清楚:

    • · 查看原书依据

      first/last。例如: 不像stop,last这个名字明显是包含的。 除了first/last,min/max这两个名字也适用于包含的范围,如果它们在上下文中“听上去合理”的话。

    • · 查看原书依据

      begin/end。 但是end这个词有点二义性。例如,在句子“我读到这本书的end部分了”,这里的end是包含的。遗憾的是,英语中没有一个合适的词来表示“刚好超过最后一个值”。 因为对begin/end的使用是如此常见(至少在C++标准库中是这样用的,还有大多数需要“

    • · 查看原书依据

      终点是非包含的。因此A、B和C互相之间不会有重复,但是D与所有其他重复。 下面是对OverlapsWith()实现的一个尝试——它检查是否自身范围的任意一个端点在other的范围之内: 尽管只有两行代码,但是里面包含很多东西。下图给出其中所有的逻辑。 这里面有太多的情况

    参考来源

    - 位置:《编写可读代码的艺术》截断长度与包含上限(spine 2777;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2701.html`;来源键`s2777-ch03-003`)。 - 结论依据:本项正文与图53..76完整实读;区分名称约定、真实实现契约及旧版本性能例,不复制原文已识别的均值/中值笔误。 - 原始内容:max_或者min_。 在本例中,名字应当是MAX_ITEMS_IN_CART,新代码现在变得简单又清楚: - 位置:《编写可读代码的艺术》包含两端范围的命名(spine 2778;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2702.html`;来源键`s2778-ch03-003`)。 - 结论依据:本项正文与图53..76完整实读;区分名称约定、真实实现契约及旧版本性能例,不复制原文已识别的均值/中值笔误。 - 原始内容:first/last。例如: 不像stop,last这个名字明显是包含的。 除了first/last,min/max这两个名字也适用于包含的范围,如果它们在上下文中“听上去合理”的话。 - 位置:《编写可读代码的艺术》起点包含、终点排除的命名(spine 2779;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2703.html`;来源键`s2779-ch03-003`)。 - 结论依据:本项正文与图53..76完整实读;区分名称约定、真实实现契约及旧版本性能例,不复制原文已识别的均值/中值笔误。 - 原始内容:begin/end。 但是end这个词有点二义性。例如,在句子“我读到这本书的end部分了”,这里的end是包含的。遗憾的是,英语中没有一个合适的词来表示“刚好超过最后一个值”。 因为对begin/end的使用是如此常见(至少在C++标准库中是这样用的,还有大多数需要“ - 位置:《编写可读代码的艺术》从不重叠反向简化区间判断(spine 2830;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2753.html`;来源键`s2830-ch03-003`)。 - 结论依据:本项正文与图198..224实读;实际图像中的表达式、区间开闭及宏范围均已读取,改写条件在正文中明示。 - 原始内容:终点是非包含的。因此A、B和C互相之间不会有重复,但是D与所有其他重复。 下面是对OverlapsWith()实现的一个尝试——它检查是否自身范围的任意一个端点在other的范围之内: 尽管只有两行代码,但是里面包含很多东西。下图给出其中所有的逻辑。 这里面有太多的情况