CC-mode

From WikEmacs
Revision as of 00:07, 26 May 2012 by Mctpyt (talk | contribs)
Jump to navigation Jump to search
C
Library cc-mode
Command c-mode
Builtin yes
Auto-activates for *.c *.h *.xbm *.xpm *.y *.yacc *.lex *.i *.m


c-mode is the default major mode for editing C source files. Its major features are customizable indentation and font-locking (coloring of code).



Basic setup

c-mode is bundled with Emacs by default. No additional setup is required.

Helpful keybindings

[C-M-a]
Go to the beginning of the current function. If you are between 2 functions, go the start of the previous one.
[C-M-e]
Go to the end of the current function. If you are between 2 functions, go to the end of the next one.
[C-M-h]
Mark current function
[M-a]
Go to beginning of current statement (or next one).
[M-e]
Go to end of current statement (or previous one).

Common Customization

Style

Any mode based on cc-mode provides automatic indentation. The default style is gnu. It is the one recommended by the Free Software Foundation for GNU projects but you can use a different one.

Here is a basic list of predefined styles:

gnu
The default style for GNU projects
k&r
What Kernighan and Ritchie, the authors of C used in their book
bsd
What BSD developers use, aka “Allman style” after Eric Allman.
whitesmith
Popularized by the examples that came with Whitesmiths C, an early commercial C compiler.
stroustrup
What Stroustrup, the author of C++ used in his book
ellemtel
Popular C++ coding standards as defined by “Programming in C++, Rules and Recommendations,” Erik Nyquist and Mats Henricson, Ellemtel
linux
What the Linux developers use for kernel development
python
What Python developers use for extension modules
java
The default style for java-mode (see below)
user
When you want to define your own style

You can look the cc-mode documentation for a complete list of builtin style. For visual example of each style you can look the Wikipedia article on indenting style.

  • The default style is set via the variable c-default-style
  • Use [C-c .] (or M-x c-set-style) to change the indentation style of the current buffer.
  • The amount of space use to indent is set via the variable c-basic-offset.

To set the default style to K&R and use 4 spaces, add this to your Emacs configuration file:

; set k&r style
(setq c-default-style "k&r")
; indent with 4 spaces
(setq c-basic-offset 4)


GNU/Linux

OS X

Windows

Emacs-24

Emacs-23

Recommended Reading

Project Pages


Tutorial Pages

Nice visual preview of different cc mode styles: http://davidha.wordpress.com/2009/05/15/emacs-cc-modes-built-in-styles-gallery/