Questions tagged «naming»

以最少的字符数给出含义和解释,其形式应为整个团队或整个社区所接受。

3
努力不使用匈牙利符号
我见过支持和反对匈牙利系统的争论。多年来,我一直在使用该系统的旧项目上工作,方法是命名每个变量,并使用变量类型的前缀(例如(strName,intAge,btnSubmit等))进行命名(我知道原始的匈牙利应用前缀是变量,而不是类型)。我希望我的下一个项目完全放弃它,但是我确实发现很难不借助它来唯一地命名类似的东西。 可以说我有一个用于收集电子邮件地址并将其存储在数据库表中的网络表单,还有一个按钮,它调用了将地址保存到数据库的函数。 如果我使用的是匈牙利风格符号,则可以将该框txtEmail称为按钮,btnEmail并将其称为textbox中包含的值strEmail。然后,我可能会使用一个功能storeEmail(strEmail)来存储电子邮件。我这里有一个明确的约定,很明显每个变量是什么。 命名这些变量的最佳实践是什么 不求助于匈牙利系统 而不会使它们长时间或令人困惑 并在整个项目中使用明确的约定?
10 naming  hungarian 

4
Word表示文件和文件夹的超集[关闭]
已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗?更新问题,以便通过编辑此帖子以事实和引用的形式回答。 4年前关闭。 我正在尝试为可以代表文件和文件夹的类命名。有人知道这个词吗?
10 naming 

7
在规范文档,用例或场景中,您如何称呼客户的客户?
我和我的团队开发了客户可以用来与客户互动的软件。此外,我们还吃自己的狗粮,并自己使用该软件与客户互动。 因此,有时可能很难解释用例和场景,因为我们的员工可以是操作员,我们的客户可以是操作员,而我们的客户的客户可以是访客。 但是,我们的客户也可以是与我们的运营商员工互动的访客,我们的客户的顾客可以是与我们的客户或员工互动的访客。 这是一个模型,其中: A is an employee B is a customer C is our customers' customer X interacts with Y Operator --> Visitor A --> B A --> C B --> C 因为有时我们的客户可以扮演不同的角色,所以有时有必要引用特定的角色,即操作员或访客,而不是雇员和客户。 一直说“客户的顾客”也是一个大嘴巴。 我想知道其他开发商店在编写用例和场景时如何处理这些语义细节。 是否有任何一个单词的通用术语可适用于涉及三级参与者的任何产品? 除了使用特定角色(运营商和访客)以外,还可以使用哪些词来识别客户的客户? 这个词必须足够短以便在组织内采用。如果音节长于一对音节,则它的缩写形式必须与其他演员区分开。

5
如何在下拉标签中引用ByRef和ByVal?[关闭]
已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗?更新问题,以便通过编辑此帖子以事实和引用的形式回答。 4年前关闭。 关于MSDN页面ByRef和ByVal关键字不是很有帮助;除非我以某种方式略过它,否则它们到处都被简单地称为“关键字”。 Rubberduck项目的主要贡献者之一是进行非常酷的Encapsulate Field重构,并且UI进行得非常好..除了我对ByRef/ 下拉菜单上方的标签有问题ByVal,它说“ Accessibility”: 我不喜欢“辅助功能”,因为我用它在其他地方Public/ Private/ Friend访问修饰符在那里感觉更准确。 我不想使用“修饰符”,因为IMO只是“访问修饰符”的缩写。 我希望该标签准确无误,但我的词汇表显然缺乏,而且我不知道该怎么称呼这些关键字。 这个标签应该说什么呢?我在找什么字?ByRef/ ByVal属于什么“关键字家族” ?
9 naming  ui  vba 

3
如何处理具有相同名称的类(不同的包)
我和我的研发团队维护着庞大的代码库。我们已经将业务逻辑分为多个包。其中一些具有相同名称的类。 如您所料,当在同一Java文件中引用两个类时,名称冲突。 例如: com.myapp.model (package) - Device (class) - ... com.myapp.data (package) - Device (class) - ... 我们就治疗这些病例的最佳实践进行了辩论,并提出了以下选择: 第一种选择 重命名类,添加前缀 ModelDevice DataDevice 第二选择 同时引用包和类的完整名称 com.myapp.model.Device com.myapp.data.Device 在代码管理和可伸缩性方面,更正确的是什么? 我们目前正在混合使用这两种方法,并开始出现不一致之处

5
如何使从外部访问函数显而易见?
这是一个特定于C的问题。我试图将所有可能的内容都保留在翻译单元的边界之内,仅通过.h文件公开一些功能。也就是说,我正在static链接到文件级对象。 现在,其他模块需要调用几个函数,而不是直接调用。我的模块/文件/翻译单元订阅其他模块,将指针传递给函数。然后,在发生特定事件时,将使用一些参数来调用指针。 因此,我想知道如何使这些功能从某个晦涩难懂的位置调用变得非常明显。 它们应该是static还是extern(并将它们显示在中.h)? 我应该在函数名称中包含一些提示吗? 还是发表一个“由X调用”的评论就足够了?

3
为什么将Quicksort称为“ Quicksort”?
这个问题的重点在于,与其他任何排序算法相比,它的优点不容置疑-当然还有许多其他问题。这个问题是关于名字的。为什么将Quicksort称为“ Quicksort”?当然,大多数情况下都是“快速”,但并非总是如此。简并为O(N ^ 2)的可能性是众所周知的。对Quicksort进行了各种修改以缓解此问题,但那些将最坏情况降低到保证的O(n log n)的修改通常不再称为Quicksort。(例如Introsort)。 我只是想知道为什么在所有众所周知的排序算法中,这是唯一应得的“快速”名称,它不描述算法的工作原理,而是描述算法的速度(通常)。之所以称为Mergesort,是因为它合并了数据。之所以称为Heapsort,是因为它使用堆。Introsort的名称来自“ Introspective”,因为它会监视自己的性能来决定何时从Quicksort切换到Heapsort。同样,对于所有较慢的变量-Bubblesort,Insertion排序,Selection排序等,它们均以其工作方式命名。我能想到的唯一一个例外是“ Bogosort”,它实际上只是一个笑话,没人在实践中实际使用过。为什么Quicksort不能称为更具描述性的名称,例如“分区排序”或“数据透视排序”,哪个描述了它的实际作用?甚至都不是“先到这里”的情况。Mergesort的开发比Quicksort早了15年。(根据维基百科分别为1945年和1960年) 我想这确实是一个历史问题,而不是编程问题。我很好奇它的名字-只是好的营销?

1
相关类和接口的命名
我创建了一个ObjectParser类,该类使用IObjectParserDataSource用作数据源将数据解析为强类型对象(数据可以是Excel文件,文本文件,数组,查询字符串等)。 我的实现示例IObjectParserDataSource包括: TextFileObjectParserDataSource ExcelFileObjectParserDataSource 这些类名对我来说真的很长且令人困惑。 我可以给他们起个名字: TextFileDataSource ExcelFileDataSource 但这带来了一定程度的模糊性,IObjectParserDataSource乍一看它们之间并没有那么明显地相关。这一点很重要,因为定义这些数据源将在客户端代码中进行,并且我希望将潜在的混乱和不确定性降至最低。 在这种情况下,您将如何命名这些类?

1
与(通用)框架名称冲突的类名称应该怎么做
当框架使用最明显的组件类名称时,应该怎么做?就我而言,我需要创建一个描述HTTP请求的类。当然,最常用的名称是“采用”为System.Web.HttpRequest。我该怎么办?该项目将在Web上下文中使用,所以我真的不想强迫人们不要导入System.Web命名空间,或者手动键入我所有的类名。 处理此问题的通常方法是什么?我可以提出: 带项目简称的前缀类名 尝试使用不同的名称表示相同的意思(我已经尝试过,但无法提出任何建议) 强制用户在名称空间之间进行选择
9 c#  .net  naming  namespace 

5
具有不带扩展名的C ++头文件是一种好习惯吗?
关于我要遵循的C ++准则,我和我的一位同事争论不休。 他目前以这种方式设计他的所有库: 他在文件名中使用大小写不一致的字母 他的某些标题没有任何扩展名 我相信没有扩展名是C ++标准文件所保留的东西,并且使用大写字母容易出错(尤其是当您处理要在Windows和Linux上都可以使用的代码时)。 他的观点是,他遵循Qt惯例(即使对于不使用Qt的代码),并一直说:“如果Qt那样做,那就不错了。” 现在,我尝试保持开放的态度,但是当我不得不使用他的库时,我真的很难过。是否有一套与此相关的通用规则?标准是否说明了这一点? 非常感谢你。
9 c++  naming 

5
如何避免类与本机类之间的名称相似?[关闭]
已关闭。这个问题需要更加集中。它当前不接受答案。 想改善这个问题吗?更新问题,使其仅通过编辑此帖子来关注一个问题。 4年前关闭。 我刚遇到一个“有趣的问题”,我想请您就以下问题提出意见: 我正在开发一个系统,由于多种原因(含义:抽象,技术独立性等),我们创建了自己的信息交换类型。 例如:如果有一个称为SendEmail的方法并由业务逻辑调用,则该方法具有类型OurCompany.EMailMessage的参数,该参数是完全与技术无关的对象,并且仅包含“与业务相关的数据”(对于例如,除了头编码之外,没有其他信息)。 在SendEmail函数内部,我们从EMailMEssage对象获取此信息,并创建一个MailMessage对象(该对象是特定于技术的),以便可以通过网络发送它。 您已经注意到,我们的类与“本地”语言类的名称非常相似。问题是:这正是电子邮件的含义,因此很难为它们找到另一个有意义的名称。 您经常遇到这个问题吗?您如何管理? 编辑:@mgkrebbs刚刚评论了使用完全限定的名称。这是我们目前的方法,但是恕我直言有点太冗长了。如果可能的话,我想要更清洁的东西。

4
版本控制中存储的图像的文件命名约定?
我的应用程序有一个存储在版本控制中的图标文件。现在明天我可能决定更改图标。我正在讨论图标文件的两种可能的命名约定: 保持文件名固定,例如application.ico 使文件名反映图像的性质,例如happyface.ico 选项1没有说明文件是什么。它可能会给人一种错觉,即两个完全不同的图像是同一事物的不同“版本”。使用选项2,我不仅必须添加一个新文件并删除旧文件,而且还必须修改资源文件以反映新图标的文件名。 从一个相关但不同的角度来看: 一个带有标题图像的网站。文件名是header.jpg还是Sunrise-family-smiling.jpg? 图像文件名是否应反映其在应用程序中的功能或内容?最佳做法是什么?

4
命名类使人衰弱[关闭]
已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗?更新问题,以便通过编辑此帖子以事实和引用的形式回答。 4年前关闭。 我不确定这是否是OCD特性,但是我发现有时我被完全阻塞,无法继续命名我认为要在外部使用的类(或函数或名称空间等)时所做的工作给定项目的 以API为例。或实用程序类库。 如果命名不完全正确(在我看来),我就是无法继续...我陷入了试图提供正确名称的困境。我尝试编写一些小应用程序,用它来查看名称,但似乎无济于事... 我知道这无关紧要,并且以任何编程思维为前提,假设您一开始就可以完美使用它……我只是对此感到无能为力…… 任何提示/想法将不胜感激...

2
API应该使用en_US还是en_GB或两者都使用?[关闭]
已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗?更新问题,以便通过编辑此帖子以事实和引用的形式回答。 4年前关闭。 我应该用美式拼写还是英式拼写编写API?还是我应该将它们都映射到一个并在内部使用我喜欢的任何人来使它们都能工作?目前,大多数API都使用美国拼写。有什么解决方案? 编辑:有没有一种方法可以对此进行标准化。可能两者都支持?

4
Java抽象类命名
例: 您为Ajax操作创建一个抽象类。不同的Ajax操作都将扩展此类。 问题: 您将类命名为AjaxAction还是AbstractAjaxAction吗? 创建子类时,是否给它们命名: 行动 AjaxAction 只要给他们起名字就好 我一直找不到“正式”约定。我看不到子类中需要 “抽象”前缀或任何必需的命名约定。(可能仍然适合,具体取决于。) 有正式的公约吗?你能把我链接到它吗?您对此主题有何看法?
9 java  naming 
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.