I want to use the correct term to make my API as intuitive as possible, so when a parameter is expected to be a full path and filename (ex “C:\Users\Max\Documents\MyDocument.txt”) what is the correct term?
- filename – that would just be MyDocument.txt, right?
- path – that would just be C:\Users\Max\Documents, right?
What should I use for the parameter name? Would “file” be the appropriate name?
I feel kind of dumb asking this, but I want to make sure it’s right.
The correct term is “Fully Qualified Name” (sometimes “FQN”).
The term you should use in your API is “QualifiedName” or “QualifiedFilename”
Wikipedia has an entry for “Fully qualified file name” and defines it as “a file on a computer whose exact name is completely specified such that it is unambiguous and cannot be mistaken for any other file on that system.”