Camel case explained

Camel case (sometimes stylized autologically as camelCase or CamelCase, also known as camel caps or more formally as medial capitals) is the practice of writing phrases without spaces or punctuation and with capitalized words. The format indicates the first word starting with either case, then the following words having an initial uppercase letter. Common examples include YouTube,[1] PowerPoint, HarperCollins, FedEx, iPhone, eBay,[2] and LaGuardia.[3] Camel case is often used as a naming convention in computer programming. It is also sometimes used in online usernames such as JohnSmith, and to make multi-word domain names more legible, for example in promoting EasyWidgetCompany.com. In fact, WikiWikiWeb, an ancestor of Wikipedia, is written in camel case.

The more specific terms Pascal case and upper camel case refer to a joined phrase where the first letter of each word is capitalized, including the initial letter of the first word. Similarly, lower camel case (also known as dromedary case) requires an initial lowercase letter. Some people and organizations, notably Microsoft, use the term camel case only for lower camel case, designating Pascal case for the upper camel case. Some programming styles prefer camel case with the first letter capitalized, others not.[4] [5] [6] For clarity, this article leaves the definition of camel case ambiguous with respect to capitalization, and uses the more specific terms when necessary.

Camel case is distinct from several other styles: title case, which capitalizes all words but retains the spaces between them; Tall Man lettering, which uses capitals to emphasize the differences between similar-looking product names such as predniSONE and predniSOLONE; and snake case, which uses underscores interspersed with lowercase letters (sometimes with the first letter capitalized). A combination of snake and camel case (identifiers Written_Like_This) is recommended in the Ada 95 style guide.[7]

Variations and synonyms

The practice has various names, including:

The earliest known occurrence of the term "InterCaps" on Usenet is in an April 1990 post to the group alt.folklore.computers by Avi Rappoport.[22] The earliest use of the name "Camel Case" occurs in 1995, in a post by Newton Love.[23] Love has since said, "With the advent of programming languages having these sorts of constructs, the humpiness of the style made me call it HumpyCase at first, before I settled on CamelCase. I had been calling it CamelCase for years. ... The citation above was just the first time I had used the name on USENET."[24]

Traditional use in natural language

In word combinations

The use of medial capitals as a convention in the regular spelling of everyday texts is rare, but is used in some languages as a solution to particular problems which arise when two words or segments are combined.

In Italian, pronouns can be suffixed to verbs, and because the honorific form of second-person pronouns is capitalized, this can produce a sentence like non ho trovato il tempo di risponderLe ("I have not found time to answer you" – where Le means "to you").

In German, the medial capital letter I, called Binnen-I, is sometimes used in a word like StudentInnen ("students") to indicate that both Studenten ("male students") and Studentinnen ("female students") are intended simultaneously. However, mid-word capitalization does not conform to German orthography apart from proper names like McDonald; the previous example could be correctly written using parentheses as Student(inn)en, analogous to "congress(wo)men" in English.[25]

In Irish, camel case is used when an inflectional prefix is attached to a proper noun, for example Irish: i nGaillimh ("in Galway"), from Irish: Gaillimh ("Galway"); Irish: an tAlbanach ("the Scottish person"), from Irish: Albanach ("Scottish person"); and Irish: go hÉirinn ("to Ireland"), from Irish: Éire ("Ireland"). In recent Scottish Gaelic orthography, a hyphen has been inserted: Irish: an t-Albannach.

This convention is also used by several written Bantu languages (e.g. isiZulu, "Zulu language") and several indigenous languages of Mexico (e.g. Nahuatl, Totonacan, Mixe–Zoque, and some Oto-Manguean languages).

In Dutch, when capitalizing the digraph ij, both the letter I and the letter J are capitalized, for example in the country name IJsland ("Iceland").

In Chinese pinyin, camel case is sometimes used for place names so that readers can more easily pick out the different parts of the name. For example, places like Beijing (北京), Qinhuangdao (秦皇岛), and Daxing'anling (大兴安岭) can be written as BeiJing, QinHuangDao, and DaXingAnLing respectively, with the number of capital letters equaling the number of Chinese characters. Writing word compounds only by the initial letter of each character is also acceptable in some cases, so Beijing can be written as BJ, Qinghuangdao as QHD, and Daxing'anling as DXAL.

In English, medial capitals are usually only found in Scottish or Irish "Mac-" or "Mc-" names, where for example MacDonald, McDonald, and Macdonald are common spelling variants of the same name, and in Anglo-Norman "Fitz-" names, where for example both FitzGerald and Fitzgerald are found.

In their English style guide The King's English, first published in 1906, H. W. and F. G. Fowler suggested that medial capitals could be used in triple compound words where hyphens would cause ambiguity—the examples they give are KingMark-like (as against King Mark-like) and Anglo-SouthAmerican (as against Anglo-South American). However, they described the system as "too hopelessly contrary to use at present".[26]

In transliterations

In the scholarly transliteration of languages written in other scripts, medial capitals are used in similar situations. For example, in transliterated Hebrew, haIvri means "the Hebrew person" or "the Jew" and b'Yerushalayim means "in Jerusalem". In Tibetan proper names like rLobsang, the "r" stands for a prefix glyph in the original script that functions as tone marker rather than a normal letter. Another example is ts

Iurku, a Latin transcription of the Chechen term for the capping stone of the characteristic Medieval defensive towers of Chechnya and Ingushetia; the letter "I" (palochka) is not actually capital, denoting a phoneme distinct from the one transcribed as "i".

In abbreviations

Medial capitals are traditionally used in abbreviations to reflect the capitalization that the words would have when written out in full, for example in the academic titles PhD or BSc. A more recent example is NaNoWriMo, a contraction of National Novel Writing Month and the designation for both the annual event and the nonprofit organization that runs it. In German, the names of statutes are abbreviated using embedded capitals, e.g. StGB for (Criminal Code), PatG for (Patent Act), BVerfG for (Federal Constitutional Court), or the very common GmbH, for (private limited company). In this context, there can even be three or more camel case capitals, e.g. in TzBfG for (Act on Part-Time and Limited Term Occupations). In French, camel case acronyms such as OuLiPo (1960) were favored for a time as alternatives to initialisms.

Camel case is often used to transliterate initialisms into alphabets where two letters may be required to represent a single character of the original alphabet, e.g., DShK from Cyrillic ДШК.

History of modern technical use

Chemical formulas

The first systematic and widespread use of medial capitals for technical purposes was the notation for chemical formulas invented by the Swedish chemist Jacob Berzelius in 1813. To replace the multitude of naming and symbol conventions used by chemists until that time, he proposed to indicate each chemical element by a symbol of one or two letters, the first one being capitalized. The capitalization allowed formulas like "NaCl" to be written without spaces and still be parsed without ambiguity.[27] [28]

Berzelius' system continues to be used, augmented with three-letter symbols such as "Uue" for unconfirmed or unknown elements and abbreviations for some common substituents (especially in the field of organic chemistry, for instance "Et" for "ethyl-"). This has been further extended to describe the amino acid sequences of proteins and other similar domains.

Early use in trademarks

Since the early 20th century, medial capitals have occasionally been used for corporate names and product trademarks, such as

Computer programming

In the 1970s and 1980s, medial capitals were adopted as a standard or alternative naming convention for multi-word identifiers in several programming languages. The precise origin of the convention in computer programming has not yet been settled. A 1954 conference proceedings[32] occasionally informally referred to IBM's Speedcoding system as "SpeedCo". Christopher Strachey's paper on GPM (1965),[33] shows a program that includes some medial capital identifiers, including "NextCh" and "WriteSymbol".

Multiple-word descriptive identifiers with embedded spaces such as end of file or char table cannot be used in most programming languages because the spaces between the words would be parsed as delimiters between tokens. The alternative of running the words together as in endoffile or chartable is difficult to understand and possibly misleading; for example, chartable is an English word (able to be charted), whereas charTable means a table of chars .

Some early programming languages, notably Lisp (1958) and COBOL (1959), addressed this problem by allowing a hyphen ("-") to be used between words of compound identifiers, as in "END-OF-FILE": Lisp because it worked well with prefix notation (a Lisp parser would not treat a hyphen in the middle of a symbol as a subtraction operator) and COBOL because its operators were individual English words. This convention remains in use in these languages, and is also common in program names entered on a command line, as in Unix.

However, this solution was not adequate for mathematically oriented languages such as FORTRAN (1955) and ALGOL (1958), which used the hyphen as an infix subtraction operator. FORTRAN ignored blanks altogether, so programmers could use embedded spaces in variable names. However, this feature was not very useful since the early versions of the language restricted identifiers to no more than six characters.

Exacerbating the problem, common punched card character sets of the time were uppercase only and lacked other special characters. It was only in the late 1960s that the widespread adoption of the ASCII character set made both lowercase and the underscore character _ universally available. Some languages, notably C, promptly adopted underscores as word separators, and identifiers such as end_of_file are still prevalent in C programs and libraries (as well as in later languages influenced by C, such as Perl and Python). However, some languages and programmers chose to avoid underscores—among other reasons to prevent confusing them with whitespace—and adopted camel case instead.

Charles Simonyi, who worked at Xerox PARC in the 1970s and later oversaw the creation of Microsoft's Office suite of applications, invented and taught the use of Hungarian Notation, one version of which uses the lowercase letter(s) at the start of a (capitalized) variable name to denote its type. One account claims that the camel case style first became popular at Xerox PARC around 1978, with the Mesa programming language developed for the Xerox Alto computer. This machine lacked an underscore key (whose place was taken by a left arrow "←"), and the hyphen and space characters were not permitted in identifiers, leaving camel case as the only viable scheme for readable multiword names. The PARC Mesa Language Manual (1979) included a coding standard with specific rules for upper and lower camel case that was strictly followed by the Mesa libraries and the Alto operating system. Niklaus Wirth, the inventor of Pascal, came to appreciate camel case during a sabbatical at PARC and used it in Modula, his next programming language.[34]

The Smalltalk language, which was developed originally on the Alto, also uses camel case instead of underscores. This language became quite popular in the early 1980s, and thus may also have been instrumental in spreading the style outside PARC.

Upper camel case (or "Pascal case") is used in Wolfram Language in computer algebraic system Mathematica for predefined identifiers. User defined identifiers should start with a lower case letter. This avoids the conflict between predefined and user defined identifiers both today and in all future versions.

C# variable names are recommended to follow the lower camel case convention.[35]

Computer companies and products

Whatever its origins in the computing field, the convention was used in the names of computer companies and their commercial brands, since the late 1970s — a trend that continues to this day:

Spread to mainstream usage

In the 1980s and 1990s, after the advent of the personal computer exposed hacker culture to the world, camel case then became fashionable for corporate trade names in non-computer fields as well. Mainstream usage was well established by 1990:

During the dot-com bubble of the late 1990s, the lowercase prefixes "e" (for "electronic") and "i" (for "Internet",[36] "information", "intelligent", etc.) became quite common, giving rise to names like Apple's iMac and the eBox software platform.

In 1998, Dave Yost suggested that chemists use medial capitals to aid readability of long chemical names, e.g. write AmidoPhosphoRibosylTransferase instead of amidophosphoribosyltransferase.[37] This usage was not widely adopted.

Camel case is sometimes used for abbreviated names of certain neighborhoods, e.g. New York City neighborhoods SoHo (South of Houston Street) and TriBeCa (Triangle Below Canal Street) and San Francisco's SoMa (South of Market). Such usages erode quickly, so the neighborhoods are now typically rendered as Soho, Tribeca, and Soma.

Internal capitalization has also been used for other technical codes like HeLa (1983).

Current usage in computing

Programming and coding

See main article: article and Naming convention (programming). The use of medial caps for compound identifiers is recommended by the coding style guidelines of many organizations or software projects. For some languages (such as Mesa, Pascal, Modula, Java and Microsoft's .NET) this practice is recommended by the language developers or by authoritative manuals and has therefore become part of the language's "culture".

Style guidelines often distinguish between upper and lower camel case, typically specifying which variety should be used for specific kinds of entities: variables, record fields, methods, procedures, functions, subroutines, types, etc. These rules are sometimes supported by static analysis tools that check source code for adherence.

The original Hungarian notation for programming, for example, specifies that a lowercase abbreviation for the "usage type" (not data type) should prefix all variable names, with the remainder of the name in upper camel case; as such it is a form of lower camel case.

Programming identifiers often need to contain acronyms and initialisms that are already in uppercase, such as "old HTML file". By analogy with the title case rules, the natural camel case rendering would have the abbreviation all in uppercase, 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 words and write "oldHtmlFile", "parseDbmXml" or "sqlServer".[38] However, this can make it harder to recognize that a given word is intended as an acronym.[39]

Difficulties arise when identifiers have different meaning depending only on the case, as can occur with mathematical functions or trademarks. In this situation changing the case of an identifier might not be an option and an alternative name need be chosen.

Wiki link markup

Camel case is used in some wiki markup languages for terms that should be automatically linked to other wiki pages. This convention was originally used in Ward Cunningham's original wiki software, WikiWikiWeb,[40] and can be activated in most other wikis. Some wiki engines such as TiddlyWiki, Trac and PmWiki make use of it in the default settings, but usually also provide a configuration mechanism or plugin to disable it. Wikipedia formerly used camel case linking as well, but switched to explicit link markup using square brackets[41] and many other wiki sites have done the same. MediaWiki, for example, does not support camel case for linking. Some wikis that do not use camel case linking may still use the camel case as a naming convention, such as AboutUs.

Other uses

The NIEM registry requires that XML data elements use upper camel case and XML attributes use lower camel case.

Most popular command-line interfaces and scripting languages cannot easily handle file names that contain embedded spaces (usually requiring the name to be put in quotes). Therefore, users of those systems often resort to camel case (or underscores, hyphens and other "safe" characters) for compound file names like

MyJobResume.pdf.

Microblogging and social networking services that limit the number of characters in a message are potential outlets for medial capitals. Using camel case between words reduces the number of spaces, and thus the number of characters, in a given message, allowing more content to fit into the limited space. Hashtags, especially long ones, often use camel case to maintain readability (e.g. #CollegeStudentProblems is easier to read than #collegestudentproblems);[42] this practice improves accessibility as screen readers recognize CamelCase in parsing composite hashtags.[43]

In website URLs, spaces are percent-encoded as "%20", making the address longer and less human readable. By omitting spaces, camel case does not have this problem.

Readability studies

Camel case has been criticized as negatively impacting readability due to the removal of spaces and uppercasing of every word.[44]

A 2009 study of 135 subjects comparing snake case (underscored identifiers) to camel case found that camel case identifiers were recognized with higher accuracy among all subjects. Subjects recognized snake case identifiers more quickly than camel case identifiers. Training in camel case sped up camel case recognition and slowed snake case recognition, although this effect involved coefficients with high p-values. The study also conducted a subjective survey and found that non-programmers either preferred underscores or had no preference, and 38% of programmers trained in camel case stated a preference for underscores. However, these preferences had no statistical correlation to accuracy or speed when controlling for other variables.[45]

A 2010 follow-up study used a similar study design with 15 subjects consisting of expert programmers trained primarily in snake case. It used a static rather than animated stimulus and found perfect accuracy in both styles except for one incorrect camel case response. Subjects recognized identifiers in snake case more quickly than camel case. The study used eye-tracking equipment and found that the difference in speed for its subjects was primarily due to the fact that average duration of fixations for camel-case was significantly higher than that of snake case for 3-part identifiers. The survey recorded a mixture of preferred identifier styles but again there was no correlation of preferred style to accuracy or speed.[46]

External links

Notes and References

  1. Book: Fogarty . Mignon . The Grammar Devotional: Daily Tips for Successful Writing from Grammar Girl . 27 October 2009 . St. Martin's Publishing Group . 978-1-4299-6440-1 . 14 . en.
  2. Book: Brown . Adam . Understanding and Teaching English Spelling: A Strategic Guide . 21 September 2018 . Routledge . 978-1-351-62186-1 . 173–174 . en.
  3. Book: Dreyer . Benjamin . Dreyer's English: An Utterly Correct Guide to Clarity and Style . 4 August 2020 . Random House Publishing Group . 978-0-8129-8571-9 . 228 . en.
  4. Web site: Naming Conventions . Scala . 5 December 2012.
  5. Web site: Capitalization Styles - .NET Framework 1.1. 17 November 2006 . 5 December 2012.
  6. Web site: Camel Case . 10 March 2016.
  7. Web site: Ada 95 Quality and Style Guide . October 1995 . 25 January 2020 . Section 3.1.3.
  8. http://www2.tech.purdue.edu/cit/Courses/CPT355/C_Sharp_Coding_Standards_and_Guidelines.asp C# Coding Standards and Guidelines
  9. Web site: CamelCase@Everything2.com . Everything2.com . 4 June 2010.
  10. http://legacy.python.org/dev/peps/pep-0008/ Style Guide for Python Code
  11. Feldman. Ian . compoundNames . 29 March 1990 . alt.folklore.computers . 3230@draken.nada.kth.se .
  12. Web site: [#APF-1088] If class name has embedded capitals, AppGen code fails UI tests and generated hyperlinks are incorrect. – AppFuse JIRA |website=Issues.appfuse.org |access-date=4 June 2010 |archive-url=https://web.archive.org/web/20170625073321/http://issues.appfuse.org/browse/APF-1088 |archive-date=25 June 2017 |url-status=dead |df=dmy-all ].
  13. http://www.shiningstar.net/articles/articles/standards/namingconventions.asp ASP Naming Conventions
  14. Book: Iverson. Cheryl. Christiansen. Stacy. Flanagin. Annette. Fontanarosa. Phil B.. Glass. Richard M.. Gregoline. Brenda. Lurie. Stephen J.. Meyer. Harriet S.. Winker. Margaret A.. Young. Rozanne K.. AMA Manual of Style. 10th. Oxford University Press. Oxford, Oxfordshire. 2007. 978-0-19-517633-9. registration.
  15. Web site: The Brief New Century Handbook – Rules for internal capitalization . . Christine A. . Hult . Thomas N. . Huckin . https://web.archive.org/web/20120407020530/http://wps.ablongman.com/long_hult_bnch_4/63/16207/4149058.cw/content/index.html . 7 April 2012 . dmy-all .
  16. Web site: What is the name for a word containing two capital letters (like WordPad)? . AskOxford . Internet Archive . 12 June 2022 . 25 October 2008 . https://web.archive.org/web/20081025021810/http://www.askoxford.com/asktheexperts/faq/aboutwords/medial?view=uk . dead .
  17. Web site: Brad Abrams: History around Pascal Casing and Camel Casing . Blogs.msdn.com . 3 February 2004 . 4 January 2014.
  18. Web site: Pascal Case . C2.com . 27 September 2012 . 4 January 2014.
  19. Web site: NET Framework General Reference Capitalization Styles . . 17 November 2006 . 4 January 2014.
  20. Web site: WikiWord . Twiki.org . 4 June 2010 . 19 June 2010 . https://web.archive.org/web/20100619042605/http://twiki.org/cgi-bin/view/TWiki/WikiWord . dead .
  21. Web site: Wiki Case . C2.com . 8 February 2010 . 4 June 2010.
  22. Rappoport. Avi . compoundNames . 3 April 1990 . alt.folklore.computers .
  23. Web site: Newton Love . I'm happy again! – comp.os.os2.advocacy | Google Groups . Groups.google.com . 12 September 1995 . 23 May 2009.
  24. http://sluug.org/~newt/ Newton Love
  25. Book: . Richtiges und gutes Deutsch: Das Wörterbuch der sprachlichen Zweifelsfälle . Duden . 9 . Mannheim . Bibliographisches Institut . 418 . 2011 . 7th . 978-3411040971 . de.
  26. Book: Fowler. Henry W.. Henry Watson Fowler. Fowler. Francis G.. Francis George Fowler. The King's English. 19 December 2009. Oxford. 2nd. 1908. Chapter IV. Punctuation – Hyphens. http://www.bartleby.com/116/405.html. https://web.archive.org/web/20091231013710/http://bartleby.com/116/. 31 December 2009. dead.
  27. [Jöns Jacob Berzelius]
  28. [Henry M. Leicester]
  29. Book: The Trade-mark Reporter. United States Trademark Association. 1930. v. 20. 1-59888-091-8.
  30. Web site: Mister Rogers Neighborhood Season 1 (Episode 4) . 21 June 2022.
  31. Web site: Our History . unitedhealthgroup.com . 2019-05-15 .
  32. Web site: "Resume of Session 8". Digital Computers: Advanced Coding Techniques. Summer Session 1954, Massachusetts Institute of Technology . 8–6 . 1954 . 4 January 2014 . https://web.archive.org/web/20120229201504/http://bitsavers.org/pdf/mit/summer_session_1954/Digital_Computers_Advanced_Coding_Techniques_Summer_1954.pdf . 29 February 2012 . dead .
  33. Strachey . Christopher . Christopher Strachey . A General Purpose Macrogenerator . Computer Journal . 8 . 3 . 225–241 . October 1965 . 10.1093/comjnl/8.3.225. free .
  34. Book: 10.1145/1238844.1238847 . http://portal.acm.org/citation.cfm?id=1238847 . Niklaus Wirth . Proceedings of the third ACM SIGPLAN conference on History of programming languages . Modula-2 and Oberon . 3-1–3-10 . Hopl III. San Diego . 2007. 10.1.1.91.1447 . 9781595937667. 1918928.
  35. Web site: wwlpublish . Declare variables - Training . 2023-08-29 . learn.microsoft.com . en-us.
  36. News: Farhad Manjoo . Grads Want to Study on EMacs, Too . Wired.com . 30 April 2002. 4 June 2010.
  37. https://www.newscientist.com/article/mg15821399.900-feedback.html Feedback, 20 June 1998
  38. Web site: Google Java Style Guide . google.github.io . 2 November 2022.
  39. To CamelCase or Under_score. Dave Binkley. Marcia Davis. Dawn Lawrie. Christopher Morrell. 10.1.1.158.9499. IEEE. 158–167. IEEE 17th International Conference on Program Comprehension, 2009. ICPC '09.. 2009. In terms of camel-cased identifiers, this has a greater impact on identifiers that include short words and especially acronyms. For example, consider the acronym ID found in the identifier kIOuterIIDPath. Because of the run of uppercase letters, the task of reading kIOuterIIDPath, in particular the identification of the word ID, is more difficult..
  40. Andrew Lih, The Wikipedia Revolution: How a Bunch of Nobodies Created the World's Greatest Encyclopedia (New York: Hyperion, 2009), pp. 57–58.
  41. Lih, The Wikipedia Revolution, pp. 62–63, 67.
  42. Web site: Accessible Use of CamelCase and Structuring Posts . Blackwood . Jessica . Brown . Kate .
  43. Web site: Social Media Accessibility Guidelines . 12 October 2022 . 12 October 2022 . https://web.archive.org/web/20221012082805/https://accessibility.princeton.edu/guidelines/social-media#camelcase . dead .
  44. News: Against Camel Case. New York Times. Caleb Crain. 23 November 2009.
  45. To CamelCase or Under_score. Dave Binkley. Marcia Davis. Dawn Lawrie. Christopher Morrell. 10.1.1.158.9499. IEEE. 158–167. IEEE 17th International Conference on Program Comprehension, 2009. ICPC '09.. 2009. The experiment builds on past work of others who study how readers of natural language perform such tasks. Results indicate that camel casing leads to higher accuracy among all subjects regardless of training, and those trained in camel casing are able to recognize identifiers in the camel case style faster than identifiers in the underscore style..
  46. Book: (download PDF) . Bonita Sharif. Jonathan I. Maletic . 2010 IEEE 18th International Conference on Program Comprehension . An Eye Tracking Study on camelCase and under_score Identifier Styles . IEEE . 196–205 . 2010 . An empirical study to determine if identifier-naming conventions (i.e., camelCase and under_score) affect code comprehension is presented. An eye tracker is used to capture quantitative data from human subjects during an experiment. The intent of this study is to replicate a previous study published at ICPC 2009 (Binkley et al.) that used a timed response test method to acquire data. The use of eye-tracking equipment gives additional insight and overcomes some limitations of traditional data gathering techniques. Similarities and differences between the two studies are discussed. One main difference is that subjects were trained mainly in the underscore style and were all programmers. While results indicate no difference in accuracy between the two styles, subjects recognize identifiers in the underscore style more quickly.. 10.1109/ICPC.2010.41 . 10.1.1.421.6137 . 978-1-4244-7604-6 . 14170019 .