开始 - >结束|停止|完?

时间:2011-01-26 00:49:46

标签: naming-conventions

我正在编写一个类,我想知道哪一对方法对描述一个过程周期更有意义:

start() -> stop()
start() -> end()
start() -> finish()

基本上,这些方法将在执行任务之前和之后调用。

我所问的是英语(特别是编程 - 任何语言 - )哪一对更常见?

对不起,我不是母语,所以我想听听人们更喜欢哪一个。

如果不够清楚,请让我知道修复它或添加更多信息。

提前谢谢。

更新

方法的目的是在运行任务之前和之后调用任何“用户功能”。对于任务本身没什么特别的。

更新2

我不想说我正在使用哪种语言(使其成为通用),但我正在做的是一个JQuery插件,我希望该插件的用户添加他们的自定义函数以便在之前触发执行主任务后。我希望这清楚。但我正在考虑不仅为JQuery而且为PHP / Java使用答案。

4 个答案:

答案 0 :(得分:14)

取决于。

  • 如果调用该方法会中止任务或提前停止,请将其命名为abort()stop()

  • 如果调用该方法将等到任务完成,请将其称为waitFor()

  • 如果调用该方法将执行该任务的最后步骤,请将其命名为finish()

  • 如果在完成任务后调用该方法,请将其称为Dispose()cleanup()
    大多数语言都有这种方法的标准名称;使用它。

  • 更新:如果我理解您的情况,我建议您OnStarted()OnCompleted()

答案 1 :(得分:9)

这是一个相当具体的问题,但通常你可以写:

start() - >停止()
begin() - >端()

你可以使用finish()来清理和关闭程序,但更多地使用close()。

答案 2 :(得分:1)

start() and stop()对我来说最有意义,但前提是stop()方法实际上是在停止任务。 (我想到的第一个例子是Java的Thread类,它有start()和stop()方法。)

但是,如果在执行任务后执行某些操作而不是停止任务本身,则更好的描述将是该方法实际执行的操作,closeResources()cleanup()等。 / p>

仍然在某种程度上取决于环境,但鉴于更新2,像setup() and teardown()init() and completed()之类的内容会更合适吗?

答案 3 :(得分:1)

高度主观且重要的主题,一些有趣的要点是herehere

start -> stop ...开始/停止一些活动;有时提供给其他组件的服务;例如开始/停止监听套接字并处理传入的请求

start -> finish ...开始/完成某些任务,处理步骤或类似的操作;在这里,任务在某种意义上已完成,即它没有被中止或取消;例如开始迭代模型优化,完成当前迭代并返回结果

endbegin相比要好于start(想想Pascal语言构造:-) begin -> endstart -> finish可以互换