355
votes

I have a doubt about CamelCase. Suppose you have this acronym: Unesco = United Nations Educational, Scientific and Cultural Organization.

You should write: unitedNationsEducationalScientificAndCulturalOrganization

But what if you need to write the acronym? Something like:

getUnescoProperties();

Is it right to write it this way? getUnescoProperties() OR getUNESCOProperties();

3

11 Answers 11

412
votes

There are legitimate criticisms of the Microsoft advice from the accepted answer.

  • Inconsistent treatment of acronyms/initialisms depending on number of characters:
  • playerID vs playerId vs playerIdentifier.
  • The question of whether two-letter acronyms should still be capitalized if they appear at the start of the identifier:
  • USTaxes vs usTaxes
  • Difficulty in distinguishing multiple acronyms:
  • i.e. USID vs usId (or parseDBMXML in Wikipedia's example).

So I'll post this answer as an alternative to accepted answer. All acronyms should be treated consistently; acronyms should be treated like any other word. Quoting Wikipedia:

...some programmers prefer to treat abbreviations as if they were lower case words...

So re: OP's question, I agree with accepted answer; this is correct: getUnescoProperties()

But I think I'd reach a different conclusion in these examples:

  • US TaxesusTaxes
  • Player IDplayerId

So vote for this answer if you think two-letter acronyms should be treated like other acronyms.

Camel Case is a convention, not a specification. So I guess popular opinion rules.

( EDIT: Removing this suggestion that votes should decide this issue; as @Brian David says; Stack Overflow is not a "popularity contest", and this question was closed as "opinion based")

Even though many prefer to treat acronyms like any-other word, the more common practice may be to put acronyms in all-caps (even though it leads to "abominations")

Other Resources:

  • Note some people distinguish between abbreviation and acronyms
  • Note Microsoft guidelines distinguish between two-character acronyms, and "acronyms more than two characters long"
  • Note some people recommend to avoid abbreviations / acronyms altogether
  • Note some people recommend to avoid camelCase / PascalCase altogether
  • Note some people distinguish between "consistency" as "rules that seem internally inconsistent" (i.e. treating two-character acronyms different than three-character acronyms); some people define "consistency" as "applying the same rule consistently" (even if the rule is internally inconsistent)
  • Framework Design Guidelines
  • Microsoft Guidelines
20
  • 35
    1) There is no inconsistency. "Id" is an abbreviation, not an acronym. 2) It depends on the context of the identifier, i.e., class, interface, attribute, enumeration type, static field, parameter, method, property or event. If the guideline for the identifier is using PascalCase, then it would be USTaxes and PlayerId; camelCase: usTaxes and playerId. 3) It would be USId in PascalCase, usId in camelCase, and parseDbmXml in camelCase. May 26, 2015 at 13:44
  • 7
    You're right, it's an abbreviation. My point is that it should be UsTaxes, UsId. Two-letter "abbreviation or acronym" should not be treated differently than three-letters, or other "normal words." Other advice, from @Eonil's answer, is to avoid shorteners altogether. unitedStatesTaxes, or playerIdentifier. May 26, 2015 at 18:24
  • 5
    Ha ha. I doubt the confusion would arise - much - but the guidelines are, well, guidelines to prevent possible confusion. A contrived (bad) acronym example in a science context: InIN(item) vs InIn(item) (hint: IN is inch(es)). Or, IDById(id) vs IdById(id), context science (hint: ID means infectious desease). "Two characters long" - what in which context? May 28, 2015 at 23:14
  • 33
    The author of Capital Offense: How to Handle Abbreviations in CamelCase correctly invokes the term "abomination" when he writes: "While [using uppercase acronyms] works in simple cases, it leads to abominations when one abbreviation follows another: HTTPURLConnection, XMLIDREF"
    – kghastie
    Jul 14, 2015 at 18:06
  • 3
    @Frederik Krautwald: 1) There's an argument that "ID" was (at least originally) an acronym for "identity document" before it was hijacked to also mean "identification" or "identity". 2) This is a case where the natural language itself is being inconsistent (shocking, I know), because even if it were an abbreviation, almost all abbreviations are lower-cased (or at most proper-cased if they're of a proper noun which "identification" or "identity" are not) not all-caps.
    – Tom
    Oct 29, 2018 at 17:14
274
votes

Some guidelines Microsoft has written about camelCase are:

When using acronyms, use Pascal case or camel case for acronyms more than two characters long. For example, use HtmlButton or htmlButton. However, you should capitalize acronyms that consist of only two characters, such as System.IO instead of System.Io.

Do not use abbreviations in identifiers or parameter names. If you must use abbreviations, use camel case for abbreviations that consist of more than two characters, even if this contradicts the standard abbreviation of the word.

Summing up:

  • When you use an abbreviation or acronym that is two characters long, put them all in caps;

  • When the acronym is longer than two chars, use a capital for the first character.

So, in your specific case, getUnescoProperties() is correct.

15
  • 14
    I guess I should start using ID instead Id (which I use/see everywhere) Dec 19, 2013 at 2:19
  • 44
    Technically "ID" isn't an acronym (it's an abbreviation of "identifier" or "identification"), but I don't really know how/if this guideline helps with that one. :-\
    – bryant
    Apr 16, 2014 at 4:23
  • 90
    I don't think this is a good standard. Distinguishing normal acronyms, two-letter acronyms, and normal words seems overcomplicated and contrary to the idea of having a consistent naming convention.
    – Sam
    Sep 16, 2014 at 2:28
  • 59
    Also, being stated by Microsoft doesn't make something "correct".
    – Sam
    Sep 16, 2014 at 2:31
  • 80
    It's nice to know they follow their own guideline: XMLHttpRequest() originally came from Microsoft. :-)
    – Makyen
    Aug 7, 2016 at 10:06
38
votes

To convert to CamelCase, there is also Google's (nearly) deterministic Camel case algorithm:

Beginning with the prose form of the name:

  1. Convert the phrase to plain ASCII and remove any apostrophes. For example, "Müller's algorithm" might become "Muellers algorithm".
  2. Divide this result into words, splitting on spaces and any remaining punctuation (typically hyphens).
    1. Recommended: if any word already has a conventional camel case appearance in common usage, split this into its constituent parts (e.g., "AdWords" becomes "ad words"). Note that a word such as "iOS" is not really in camel case per se; it defies any convention, so this recommendation does not apply.
  3. Now lowercase everything (including acronyms), then uppercase only the first character of:
    1. … each word, to yield upper camel case, or
    2. … each word except the first, to yield lower camel case
  4. Finally, join all the words into a single identifier.

Note that the casing of the original words is almost entirely disregarded.

In the following examples, "XML HTTP request" is correctly transformed to XmlHttpRequest, XMLHTTPRequest is incorrect.

3
  • 1
    I appreciate this comment because it points to a well known example in common use today (XmlHttpRequest, despite its insanity, is everywhere on the web today). Yet, some philosophy may be in order for us here. As George Bernard Shaw said "The reasonable man adapts himself to the world: the unreasonable one persists in trying to adapt the world to himself. Therefore all progress depends on the unreasonable man." Coming from a Python community that is strong and happy, I propose unreasonably to adopt in my Python code for classes the equivalent of this: "XML_HTTP_Request".
    – legel
    Nov 22, 2022 at 17:41
  • @legel: of course, snake case is more readable than camel case, but why not e.g. xml_http_request ?
    – serv-inc
    Nov 23, 2022 at 9:08
  • 1
    Indeed, snakes > camels. The Snake_Camel is a monster I created to look like a Camel where only Camels are desired, but perform like a Snake.
    – legel
    Nov 24, 2022 at 14:42
29
votes

getUnescoProperties() should be the best solution...

When possible just follow the pure camelCase, when you have acronyms just let them upper case when possible otherwise go camelCase.

Generally in OO programming variables should start with lower case letter (lowerCamelCase) and class should start with upper case letter (UpperCamelCase).

When in doubt just go pure camelCase ;)

parseXML is fine, parseXml is also camelCase

XMLHTTPRequest should be XmlHttpRequest or xmlHttpRequest no way to go with subsequent upper case acronyms, it is definitively not clear for all test cases.

e.g. how do you read this word HTTPSSLRequest, HTTP + SSL, or HTTPS + SL (that doesn't mean anything but...), in that case follow camel case convention and go for httpSslRequest or httpsSlRequest, maybe it is no longer nice, but it is definitely more clear.

1
  • 14
    I like your HTTPSSL example, although SL doesn't mean anything, how about something like HTTPSSHTunnel? Is it HTTPS + SH (shell) or HTTP + SSH? Google convention is definitely less ambiguous.
    – L. Holanda
    Jun 20, 2019 at 23:57
16
votes

There is airbnb JavaScript Style Guide at github with a lot of stars (~57.5k at this moment) and guides about acronyms which say:

Acronyms and initialisms should always be all capitalized, or all lowercased.

Why? Names are for readability, not to appease a computer algorithm.

// bad
import SmsContainer from './containers/SmsContainer';

// bad
const HttpRequests = [
  // ...
];

// good
import SMSContainer from './containers/SMSContainer';

// good
const HTTPRequests = [
  // ...
];

// also good
const httpRequests = [
  // ...
];

// best
import TextMessageContainer from './containers/TextMessageContainer';

// best
const requests = [
  // ...
];
7
  • 23
    "Why? Names are for readability, not to appease a computer algorithm" so, XMLHTTPRequest is way better readable than XmlHttpRequest, right?
    – L. Holanda
    Sep 12, 2018 at 21:30
  • 8
    Doesn't make sense why httpRequests is considered good but HttpRequests is bad. following this principle then, for XML HTTP Request should be xmlhttpRequest???
    – L. Holanda
    Sep 12, 2018 at 21:35
  • 10
    I often cite the AirBnb style guide, but in this case I don't agree. I particularly don't agree with their statement: "Acronyms and initialisms should always be all uppercased, or all lowercased.". xmlHttpRequest is more readable than XMLHTTPRequest in my opinion.
    – RonanCodes
    Feb 26, 2020 at 15:23
  • 1
    What do you think of 'LASER', 'RADAR', "SCUBA"?They were acronyms, but nowadays they are considered as normal words widely.
    – chen3feng
    Nov 17, 2020 at 7:20
  • When you use a capitalized acronym, you basically transform it into a word by itself, which I don't think is right. Acronyms should be either all uppercased or lowercased.
    – Temperosa
    Jan 2, 2021 at 17:44
5
votes

In addition to what @valex has said, I want to recap a couple of things with the given answers for this question.

I think the general answer is: it depends on the programming language that you are using.

C Sharp

Microsoft has written some guidelines where it seems that HtmlButton is the right way to name a class for this cases.

Javascript

Javascript has some global variables with acronyms and it uses them all in upper case (but funnily, not always consistently) here are some examples:

encodeURIComponent XMLHttpRequest toJSON toISOString

2
  • 1
    Well it's Netscape old, it even has some with no camelCase like onerror.
    – Eddie
    Apr 3, 2018 at 22:21
  • I think you need a third class of items: Acronyms, Abbreviations, and File Extensions. Oct 14, 2021 at 7:23
1
vote

Currently I am using the following rules:

  1. Capital case for acronyms: XMLHTTPRequest, xmlHTTPRequest, requestIPAddress.

  2. Camel case for abbreviations: ID[entifier], Exe[cutable], App[lication].

ID is an exception, sorry but true.

When I see a capital letter I assume an acronym, i.e. a separate word for each letter. Abbreviations do not have separate words for each letter, so I use camel case.

XMLHTTPRequest is ambigous, but it is a rare case and it's not so much ambiguous, so it's ok, rules and logic are more important than beauty.

0
votes

The JavaScript Airbnb style guide talks a bit about this. Basically:

// bad
const HttpRequests = [ req ];

// good
const httpRequests = [ req ];

// also good
const HTTPRequests = [ req ];

Because I typically read a leading capital letter as a class, I tend to avoid that. At the end of the day, it's all preference.

1
  • Why not just use case? I genuinely want to hear your thoughts? Why choose one over the other?
    – YulePale
    Sep 27, 2022 at 5:18
0
votes

disclaimer: English is not my mother tone. But I've thought about this problem for a long time, esp when using node (camelcase style) to handle database since the name of table fields should be snakeized, this is my thought:

There are 2 kinds of 'acronyms' for a programmer:

  • in natural language, UNESCO
  • in computer programming language, for example, tmc and textMessageContainer, which usually appears as a local variable.

In programming world, all acronyms in natural language should be treated as word, the reasons are:

  1. when we programming, we should name a variable either in acronym style or non-acronym-style. So, if we name a function getUNESCOProperties, it means UNESCO is an acronym ( otherwise it shouldn't be all uppercase letters ), but evidently, get and properties are not acronyms. so, we should name this function either gunescop or getUnitedNationsEducationalScientificAndCulturalOrganizationProperties, both are unacceptable.

  2. natural language is evolving continuously, and today's acronyms will become words tommorow, but programs should be independent of this trend and stand forever.

by the way, in the most-voted answer, IO is the acronym in computer language meaning (stands for InputOutput), but I don't like the name, since I think the acronym (in computer language) should only be used to name a local variable but a top-level class/function, so InputOutput should be used instead of IO

1
-1
votes

There is also another camelcase convention that tries to favor readability for acronyms by using either uppercase (HTML), or lowercase (html), but avoiding both (Html).

So in your case you could write getUNESCOProperties. You could also write unescoProperties for a variable, or UNESCOProperties for a class (the convention for classes is to start with uppercase).

This rule gets tricky if you want to put together two acronyms, for example for a class named XML HTTP Request. It would start with uppercase, but since XMLHTTPRequest would not be easy to read (is it XMLH TTP Request?), and XMLhttpRequest would break the camelcase convention (is it XM Lhttp Request?), the best option would be to mix case: XMLHttpRequest, which is actually what the W3C used. However using this sort of namings is discouraged. For this example, HTTPRequest would be a better name.

Since the official English word for identification/identity seems to be ID, although is not an acronym, you could apply the same rules there.

This convention seems to be pretty popular out there, but it's just a convention and there is no right or wrong. Just try to stick to a convention and make sure your names are readable.

4
  • 3
    I don't believe this whole thread :-) So it would be XMLToHtmlConverter but HTMLToXmlConverter? Wow... Jun 3, 2016 at 14:28
  • 1
    @JosefSábl, yes, it would be like that. Regarding your downvote, I'm not saying I like this convention, but it definitely exists. Jun 3, 2016 at 14:59
  • 1
    I read the question as "What is good convention of writing Accronyms in camel case" not "Can you list all conventions that exist". And as I consider your mentioned convention as very bad, I downvoted :-) Jul 4, 2016 at 14:31
  • Well the question is "Is it right to write it this way?", and since there are many "right" ways to write it because it's just a convention, and this convention is quite popular (regardless of how you consider it), my answer is very valid :-) Jul 4, 2016 at 16:09
-1
votes

UNESCO is a special case as it is usually ( in English ) read as a word and not an acronym - like UEFA, RADA, BAFTA and unlike BBC, HTML, SSL

2
  • 1
    This is is the distinction between "acronyms" and mere "abbreviations"; this distinction would seem to be relevant to the whole discussion, but has been almost entirely elided in the answers presented.
    – simon
    Oct 31, 2016 at 17:51
  • 2
    BBC, HTML, SSL, and other acronyms where you sound out each letter are more accurately called initialisms. Words like UNESCO that are pronounced as a word are true acronyms.
    – ylysyym
    Jan 31, 2020 at 12:12

Not the answer you're looking for? Browse other questions tagged or ask your own question.