引用路径和文件名的正确术语是什么？

我想使用正确的术语使我的API尽可能直观，所以当一个参数被期望是完整的路径和文件名（例如“C：\ Users \ Max \ Documents \ MyDocument.txt”）时，什么是正确的术语？引用路径和文件名的正确术语是什么？

文件名 - 这只是MyDocument.txt，对不对？
path - 那只是C：\ Users \ Max \ Documents，对不对？

我应该用什么参数名称？ “文件”会是合适的名称吗？

我觉得有点傻，问这个，但我想确保它是正确的。

来源

2010-01-06 Max Schmeling

+1 - 我喜欢你花时间让你的API变得直观。 – 2010-01-06 22:29:18

+1 ...如果你使用的是Java或C＃，你总是可以踢，然后javadoc它。 – iandisme 2010-01-06 22:41:01

我会重复使用来自java.io.File的术语：absoluteFilePath – 2010-01-07 01:34:04

，正确的说法是“完全合格的名称”（有时“FQN”）。

您应该在API中使用的术语是“QualifiedName的”或“QualifiedFilename”

维基百科对“Fully qualified file name”的条目，并将其定义为“一个文件，其确切的名称是完全确定这样的计算机上它是明确的，不能被误认为是该系统上的任何其他文件。“

来源

2010-01-06 22:26:31

真的吗？我听说过域名的FQDN，但从来没有收到过文件。在实际使用中向我展示一段使用术语QualifiedName或QualifiedFilename的代码。 – benzado 2010-01-06 22:34:01

我想知道有多少程序员因为“合格”而不愿意这样做，答案让我感到难过。 – iandisme 2010-01-06 22:34:09

我脑海中的某个东西说有一个Java API调用了'getQualifiedName'，但是我不记得我的头顶是哪个类。 – 2010-01-06 22:35:33

经常被滥用这方面的一个词是URI，虽然你的例子是不是真的其中之一。我想如果你只是使用“文件路径”或“路径名”，你会非常清楚。

例如，Java的文件对象使用“路径”作为其File对象的构造函数的参数名称。

来源

2010-01-06 22:24:22 iandisme

一般路径是全C:\Users\Max\Documents\MyDocument.txt而C:\Users\Max\Documents\部分通常被称为基本目录或只是目录。

你会在很多示例代码的人看到写：C:\path\to\the\document.txt

来源

2010-01-06 22:25:16 slebetman

-1

我不认为有一个真正的答案，也许一些共识，但这就是我们所希望的。我通常会尝试遵循我正在使用的库的约定（例如，Cocoa，Java或PHP）。如果我没有什么去了，我会说：

文件：抽象的东西通过名称被引用：文件处理
路径：一个字符串，表示文件的位置，或目录，绝对或相对：/Users/Max/Documents/FooBar，../Sibling/Zardoz
名称：文件或目录的名称，没有位置：FooBar，Zardoz，Documents

来源

2010-01-06 22:29:32 benzado

我与FULLPATH像你说的路径是C去：\用户\中号ax \ Documents但读取完整路径会建议路径+文件名。对于一些路径指向一个文件，其中我会用“绝对目录路径”为指向的目录

在相对路径的情况下的路径

来源

2010-01-06 22:41:48 slayerIQ

我的建议是“绝对路径”的变化应该很明显。

如果没有其他内容，您可以随时在文档中对您使用的某些术语的含义进行描述。

来源

2010-01-07 16:36:18 Zuu

-1

您可能已经考虑过的一种更简单的解决方案是告诉API的使用者XML文档中的预期内容，如果您使用文档编译程序集并分发.xml文件，该文档也将出现在Visual Studio intellisense中。

/// <summary> 
/// Saves the provided file to disk. 
/// </summary> 
/// <param name="filePath">The full path, including the filename of the file.</param> 
public void SaveFile(string filePath) 
{ 

}

来源

2010-01-15 13:08:58

引用路径和文件名的正确术语是什么？

回答

相关问题