Acronyms and initialisms should always be all capitalized, or all lowercased.
The camelCasing convention, used only for parameter names, capitalizes the first character of each word except the first word, as shown in the following examples. As the example also shows, two-letter acronyms that begin a camel-cased identifier are both lowercase.
Pascal case -- or PascalCase -- is a programming naming convention where the first letter of each compound word in a variable is capitalized. The use of descriptive variable names is a software development best practice.
UpperCamelCase (part of CamelCase) is a naming convention in which a name is formed of multiple words that are joined together as a single word with the first letter of each of the multiple words capitalized within the new word that forms the name.
There is no one correct answer. This wiki extract is helpful:
Programming identifiers often need to contain acronyms and initialisms which are already in upper case, such as "old HTML file". By analogy with the title case rules, the natural camel case rendering would have the abbreviation all in upper case, namely "oldHTMLFile". However, this approach is problematic when two acronyms occur together (e.g., "parse DBM XML" would become "parseDBMXML") or when the standard mandates lower camel case but the name begins with an abbreviation (e.g. "SQL server" would become "sQLServer"). For this reason, some programmers prefer to treat abbreviations as if they were lower case words and write "oldHtmlFile", "parseDbmXml" or "sqlServer".
A "convention" is just that - it's not a "rule". However, I feel strongly that getXmlStream()
is the best option. Consider multiple such terms: compare getSQLDBIOXML()
to getSqlDbIoXml()
You should probably go for getXmlStream
. Think of parseDBMXML
or more complicated examples that make the code unreadable.
Comes from wikipedia CamelCase
I'm not saying it should
be this way but for some, they can automatically adjust/expect that when there's a sequential string of upper-cased letters followed by lower-cased letters there is an acronym somewhere. My opinion
is to go with getXmlStream()
--it's something that I think
is something easier for most people to read, compared to the number of those instantly able to read getXMLStream()
with ease..
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