I try to be grammatically correct in my naming*. I've always used filename
instead of fileName
. The java convention also seems to use this, but FxCop prefers fileName
.
There's a discussion on WikiPedia about it. The more I read, the more I feel I'm right (which is quite usual! :) ). Does anyone have a definitive answer or is this merely something subjective?
* I just hope there are no grammar errors in this post!
File naming best practices:Avoid special characters or spaces in a file name. Use capitals and underscores instead of periods or spaces or slashes. Use date format ISO 8601: YYYYMMDD.
Guidelines for names Make file and directory names lowercase. Use hyphens, not underscores, to separate words—for example, query-data.
Human readableWord boundaries in the file name can be indicated by using medial capitalization called camel case, for example “FileName”, or underscore, for example “file_name”. File names should not have any spaces or other special characters.
A File Naming Convention (FNC) is a framework for naming your files in a way that describes what they contain and how they relate to other files. Developing an FNC is done through identifying the key elements of the project, the important differences and commonalities between your files.
Lower camel case is recommended for fields and parameters.
Example 1:
fileName // for fields, parameters, etc.
FileName // for properties, class names, etc.
Generally, fileName
is used and NOT filename
; you can verify that by reading source code of open source stuff created by Microsoft, such as Enterprise Library.
Reasons:
Example 2:
fileName, fileSize... // instead of filename AND filesize
See also:
For a full set of naming convention rules, I recommend checking this book:
And also check some stuff at IDesign.net
'filename'
assumes that this word describes a singular object like 'cow' or 'chair''fileName'
assumes that this is a complex object, that there is an object called file and that this object describes the name of that file.
Two philosophical approaches, take your pick.
It is acceptable English to write "filename" or "file name". When you translate that into coding, capitalizing the "n" or not capitalizing the "n" can go either way (assuming camelCase or PascalCase).
By the way, you did make a grammatical error in the question--ironically, in the very sentence in which you were expressing your hope that there were no grammatical errors. You said, "I just hope there's no grammar errors in this post!" But "errors" is plural, therefore the "is" of "there's" represents a subject-verb disagreement.
* I just hope there are no grammatical errors in this post!
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With