Parameters 参数与参数命名:首选项还是约定?

Parameters 参数与参数命名:首选项还是约定?,parameters,naming-conventions,arguments,Parameters,Naming Conventions,Arguments,不管这看起来多么微不足道,我还是忍不住好奇。根据您的经验,在命名参数和参数时,有哪些可读性注意事项?参数在函数调用中,因此可能与函数定义中的参数具有不同的人类可读目的。什么时候参数名应该比相应的参数名更具体,反之亦然,或者在可能的情况下它们应该具有相同的名称 你知道有什么惯例或标准可以帮助你决定一种方式或另一种方式吗?或者你会说这是属于偏好的范畴吗 提前感谢。嗯……当使用第三方/或框架方法时,您可能希望使参数名称更简洁/除此之外,出于一致性的考虑,您当然希望这些名称匹配 嗯……当使用第三方/或框

不管这看起来多么微不足道,我还是忍不住好奇。根据您的经验,在命名参数和参数时,有哪些可读性注意事项?参数在函数调用中,因此可能与函数定义中的参数具有不同的人类可读目的。什么时候参数名应该比相应的参数名更具体,反之亦然,或者在可能的情况下它们应该具有相同的名称

你知道有什么惯例或标准可以帮助你决定一种方式或另一种方式吗?或者你会说这是属于偏好的范畴吗


提前感谢。

嗯……当使用第三方/或框架方法时,您可能希望使参数名称更简洁/除此之外,出于一致性的考虑,您当然希望这些名称匹配

嗯……当使用第三方/或框架方法时,您可能希望使参数名称更简洁/除此之外,出于一致性的考虑,您当然希望这些名称匹配

参数和参数作为术语通常可以互换使用,但如果我们想更具体一些,通常可以归结为:

参数只是函数定义中的一个名称

参数是将传递给该函数的对象

假设您有一个函数可以接受数据库连接:

public void doDatabaseStuff (DatabaseConnection dbConnection) {...}
这里,
dbConnection
是一个参数

当您实际使用此功能时,如果您使用的是Oracle数据库,则可以将该
数据库连接
命名为
oracleDbConnection
,并按如下方式使用:

DatabaseConnection oracleDbConnection = // some code to actually obtain that connection
doDatabaseStuff(oracleDbConnection);
在这里,我们有两件事:

  • dbConnection
    是参数名
  • oracleDbConnection
    是参数名

从这里,我们可以看到参数名通常比参数名更“通用”,但不必如此。您也可以只使用
dbConnection
作为参数名,但
oracleDbConnection
更有意义。

参数和参数作为术语通常可以互换使用,但如果我们想更具体一些,通常可以归结为:

参数只是函数定义中的一个名称

参数是将传递给该函数的对象

假设您有一个函数可以接受数据库连接:

public void doDatabaseStuff (DatabaseConnection dbConnection) {...}
这里,
dbConnection
是一个参数

当您实际使用此功能时,如果您使用的是Oracle数据库,则可以将该
数据库连接
命名为
oracleDbConnection
,并按如下方式使用:

DatabaseConnection oracleDbConnection = // some code to actually obtain that connection
doDatabaseStuff(oracleDbConnection);
在这里,我们有两件事:

  • dbConnection
    是参数名
  • oracleDbConnection
    是参数名
从这里,我们可以看到参数名通常比参数名更“通用”,但不必如此。您也可以只使用
dbConnection
作为参数名,但是
oracleDbConnection
更有意义