百分比,百分比,分数,比例因子的术语?

时间:2011-12-27 15:51:05

标签: language-agnostic naming-conventions

我有概念所有返回相同内容的函数,但结果可能采用不同的形式:

function GetThingy()

有四种不同的功能,每种功能都可以返回不同的东西:

  • 0.071float值代表增加7.1%)
  • 7.1float值代表增加7.1%)
  • 1.071float值代表增加7.1%)
  • "7.1%"string值代表7.1%的百分比)

我可以使用哪些术语来帮助记录这些函数的返回值?

我想出了自己的术语:

  • 分数:一个分数;其中值被理解为介于0..1之间(例如0.07代表7%)
  • 百分比每百个值;其中值被理解为介于0..100之间(例如7代表7%)注意:这与分数形成鲜明对比,每一个而不是每百个
  • 因素A scale factor, that can be used to directly multiply;被理解为相当于 1 +分数(例如1.07意味着增加7%)
  • 百分比:包含实际百分比字符字符串(即),适合显示到用户或喜欢本地化文本的案例(例如"7%"暗示7%)

所以将我自己的命名方案应用于函数:

  • GetThingyFraction() = 0.071
  • GetThingyPercent() = 7.1
  • GetThingyFactor() = 1.071
  • GetThingyPercentage() =“7.1%”

你说什么?

注意:我在English.stackexchange.com上问了这个问题,但没有解释就得到了回报。显然他们不喜欢与编程相关的英语问题。

让我们希望stackoverflow不讨厌与英语相关的编程问题。 更新:看起来SO 讨厌与英语相关的编程问题。

  

enter image description here“你觉得怎么样?即使是在不合适的情况下你也不合适。”

3 个答案:

答案 0 :(得分:1)

不确定是否有“回答”,但是如您所示,命名功能使消费者很容易理解他们正在回归的内容。我也喜欢你选择的术语。

您是否计划实现每个功能的所有四种(或n种)风格,或者这是否是一个严格意义上的问题,以便不同的操作以不同的方式处理结果?

我不太确定“百分比”版本的效用。通常,为消息的UI创建字符串应该在演示文稿中处理,而不是在计算中处理。演示文稿将确定小数位数,“%”与“pct”对比“百分比”等等。

答案 1 :(得分:1)

我说你刚刚得到它,但我会在某些地方添加“增加”这个词,并将你的例子放在文档/评论中:

  • GetThingyFractionIncrease()[例如0.071代表增加7.1%]
  • GetThingyPercentIncrease()[例如7.1代表增加7.1%]
  • GetThingyFactor()[例如1.071代表增加7.1%]
  • GetThingyPercentageString()[例如“7.1%”增加7.1%]

  • 答案 2 :(得分:0)

    即使你的标签与语言无关,我也假设你是用现代的面向对象编程语言编写的。

    如果您的Thingy类具有thingy对象具有私有分数,那么您可以通过以下方法允许公共访问:

    • double thingy.asFractionIncrease
    • double thingy.asPercentIncrease
    • double thingy.asFactor
    • String thingy.asPercentIncreaseString

    P.S。我要推荐你的EL& U帖子。到目前为止,这将使你回到0,你将在声誉上获得净积极性