Snake case

This article relies excessively on references to primary sources. Please improve this article by adding secondary or tertiary sources. Find sources: "Snake case" – news · newspapers · books · scholar · JSTOR (August 2015) (Learn how and when to remove this message)

Piece of code from a module of the Linux kernel, which uses snake case for identifiers.

Snake case (stylized as snake_case) is the naming convention in which each space is replaced with an underscore (_) character, and words are written in lowercase. It is a commonly used naming convention in computing, for example for variable and subroutine names, and for filenames. One study has found that readers can recognize snake case values more quickly than camel case. However, "subjects were trained mainly in the underscore style", so the possibility of bias cannot be eliminated.

A variation is screaming snake case where words are written in all caps (stylized as SCREAMING_SNAKE_CASE). This convention is used for constants in programming languages like C/C++, Python, Java, PHP, as well as for environment variables.

History

The use of underscores as word separators dates back to the late 1960s. It is particularly associated with C, is found in The C Programming Language (1978), and contrasted with pascal case (a type of camel case). However, the convention traditionally had no specific name: the Python programming language style guide refers to it simply as "lower_case_with_underscores".

Within Usenet the term snake_case was first seen in the Ruby community in 2004, used by Gavin Kistner, writing:

BTW...what *do* you call that naming style? snake_case? That's what I'll call it until someone corrects me.

However, former Intel engineer Jack Dahlgren has stated that he was using the term internally at Intel (and perhaps in dialogue with Microsoft engineers) in 2002. It is possible that the term developed independently in more than one community.

As of 2015, names for other delimiter-separated naming conventions for multiple-word identifiers have not been standardized, although some terms have increasing levels of usage, such as lisp-case, kebab-case, SCREAMING_SNAKE_CASE, and more.

Examples

The following programming languages use snake case by convention:

• ABAP
• Ada, with initial letters also capitalized
• C++, Boost
• C, for some type names in the standard library, but not for function names.
• Eiffel, for class and feature names
• Elixir, for atom, variable, and function names
• Erlang, for function names
• GDScript, for variable and function names
• Java uses SCREAMING_SNAKE_CASE for static final constants and enum values.
• Kotlin uses SCREAMING_SNAKE_CASE for constants and enum values
• Magik
• OCaml, for value, type, and module names
• Perl, for lexical variables and subroutines
• Oracle SQL and PL/SQL, for all unquoted identifiers (tables, columns, indexes, constraints, PL/SQL variables, constants, procedures/functions, triggers,...), although not official by Oracle itself, still recommended by the majority of known "influencers" and used throughout the official Oracle documentation
  • All unquoted snake_case identifiers are actually internally represented as SCREAMING_SNAKE_CASE identifiers.
• Prolog, for both atoms (predicate names, function names, and constants) and variables
• Python, for variable names, function names, method names, and module or package (i.e. file) names
• PHP uses SCREAMING_SNAKE_CASE for class constants
• PL/I
• R, for variable names, function names, and argument names, especially in the tidyverse style
• Ruby, for variable and method names
• Rust, for variable names, function names, method names, module names, and macros
• Tcl
• Terraform (software), for resources and variables
• Zig, for variables

See also

• Camel case, more common in Java and C#
• Kebab case, more common in LISP
• Naming convention (programming)

References

1. ^ Sharif, Bonita; Maletic, Jonathan I. (2010). "An Eye Tracking Study on camelCase and under_score Identifier Styles". 2010 IEEE 18th International Conference on Program Comprehension (PDF). pp. 196–205. CiteSeerX 10.1.1.421.6137. doi:10.1109/ICPC.2010.41. ISBN 978-1-4244-7604-6. S2CID 14170019.
2. ^ "Snake Case". Mozilla Developer Network. 8 September 2023. Retrieved November 10, 2023.
3. ^ a b Guido van Rossum; Barry Warsaw; Nick Coghlan (2001-07-05). "PEP 0008 -- Style Guide for Python Code".
4. ^ Gavin Kistner (2004-02-23). "Appropriate use of camelCase". Newsgroup: comp.lang.ruby. Usenet: HBn_b.379957$xy6.2073499@attbi_s02. Retrieved 2015-08-13.
5. ^ "Quora". 2013-05-10.
6. ^ "StackOverflow – What's the name for snake_case with dashes?".
7. ^ "Programmers – If this is camelCase what-is-this?". Archived from the original on 2016-08-07. Retrieved 2015-08-13.
8. ^ "Camel_SNAKE-kebab". GitHub. 23 April 2020.
9. ^ "Naming Conventions in ABAP Objects". help.sap.com. Retrieved 2020-07-28.
10. ^ "Ada Programming Guidelines".
11. ^ "Boost Library Requirements and Guidelines". Retrieved 2015-08-13.
12. ^ "Eiffel Class and Feature Names". 28 December 2019.
13. ^ "Elixir Style Guide". GitHub. May 2020.
14. ^ "Programming Rules". Archived from the original on 2010-09-04. Retrieved 2017-08-11.
15. ^ "GDScript Style Guide".
16. ^ "Code Conventions for the Java Programming Language – Naming Conventions". Oracle. Retrieved 2021-08-03.
17. ^ "Coding Conventions". Retrieved 2023-02-03.
18. ^ "Xen wiki". Retrieved 2017-03-15.
19. ^ Damian Conway (2005). Perl Best Practices. O'Reilly Media Inc. p. 44. ISBN 978-0-596-00173-5.
20. ^ "Quick Guide to Some Sources for Naming Conventions for Oracle Database Development". stevenfeuersteinonplsql.blogspot.com. Retrieved 2020-12-30.
21. ^ Michael A. Covington; Roberto Bagnara; Richard A. O'Keefe; Jan Wielemaker; Simon Price (2009). "Coding Guidelines for Prolog (v.3)". p. 14. arXiv:0911.2899 .
22. ^ IBM (July 1965). IBM Operating System/360 PL/I: Language Specifications (PDF). p. 16. Retrieved November 12, 2023.
23. ^ Wickham, Hadley. The tidyverse style guide.
24. ^ "Ruby Naming Conventions". GitHub. May 2020.
25. ^ "Naming – Rust API Guidelines". Archived from the original on 2018-09-16. Retrieved 2019-10-27.
26. ^ "Terraform Naming Conventions". Feb 2022.
27. ^ "Documentation - The Zig Programming Language". Retrieved 2024-03-10.

External links

• Snake case converter

v t e Typography
Page	Canons of page construction Column Even working Margin Page numbering Paper size Pagination Pull quote Recto and verso Intentionally blank page
Paragraph	Alignment Leading River Runaround Widows and orphans runt
Character	Typeface anatomy Counter Diacritics Dingbat Glyph Ink trap Ligature Rotation Subscript and superscript Swash Text figures Tittle Capitalization All caps Camel case Initial Letter case Small caps Snake case Title case Visual distinction Italics Oblique Bold Color printing Underline Blackboard bold Blackletter Horizontal aspects Figure space Kerning Letter-spacing Sentence spacing Space Thin space Vertical aspects Ascender Baseline Body height Cap height Descender Median Overshoot x-height
Typeface classifications	Roman type Serif Antiqua Didone slab serif Sans-serif Blackletter type Fraktur Rotunda Schwabacher Gaelic type Insular Uncial Specialist Record type Display typeface script fat face reverse-contrast
Punctuation	Dashes Hanging punctuation Hyphen-minus Hyphenation Prime mark Quotation mark
Typesetting	Etaoin shrdlu Font computer monospaced Font catalog For position only Letterpress Lorem ipsum Microprinting Microtypography Movable type Pangram Phototypesetting Punchcutting Reversing type Sort Type color Type design Typeface list
Typographic units	Agate Cicero Em En Measure Pica Point traditional point-size names Proposed metric units Twip
Digital typography	Character encoding Hinting Rasterization Typographic features Web typography Bézier curves Desktop publishing
Typography in other writing systems	Arabic Cyrillic East Asian Thai
Related articles	Calligraphy Handwriting Scribe Sofer Scrivener Style guide Type design Type foundry History of Western typography Intellectual property protection of typefaces Technical lettering Vox-ATypI classification
Related tables	List of typographical symbols and punctuation marks Punctuation and other typographic symbols (template)
Category