This dialog may be used to configure settings that will be used to automatically reindent & reformat C/C++/Java source files. This dialog can be accessed via the Artistic Style button in the TOOLS toolbar. The number of indent spaces passed to Artistic Style is based on the Indent Spaces value defined under Word Wrap/Tab Settings in Configuration based on the file extension of the active file.
Pressing the Reformat button applies the selected options/settings to the active file.
Indentation
The following indentation options are available:
|
Control |
Function |
|
class |
indents 'class' blocks so that the headers 'public:', 'protected:' and 'private:' are indented in the class block class Foo { public: Foo(); virtual ~ Foo(); }; becomes: class Foo { public: Foo(); virtual ~ Foo(); }; |
|
switch |
indents 'switch' blocks so that the 'case X:' headers are indented in the switch block switch ( foo) { case 1: a += 2; break; default: a += 3; break; } becomes: switch ( foo) { case 1: a += 2; break; default: a += 2; break; } |
|
case |
indents 'case X:' lines so that they are flush with the command lines under them switch ( foo) { case 1: { a += 2; break; } default: { a += 2; break; } } becomes: switch ( foo) { case 1: { a += 2; break; } default: { a += 2; break; } } |
|
brackets |
adds extra indentation to brackets if ( isFoo) { bar(); } else { anotherBar(); } becomes: if ( isFoo) { bar(); } else { anotherBar(); } |
|
blocks |
adds extra indentation to entire blocks if ( isFoo) { bar(); } else anotherBar(); becomes: if ( isFoo) { bar(); } else anotherBar(); |
|
label |
adds extra indentation to labels so they appear 1 indent less than the current indentation, rather than being flushed to the left (the default). int foo() { while ( isFoo) { ... goto error; error: ... } } becomes: int foo() { while ( isFoo) { ... goto error; error: ... } } |
|
namespace |
adds extra indentation to namespaces namespace foospace { class Foo { public: Foo(); virtual ~ Foo(); }; } becomes: namespace foospace { class Foo { public: Foo(); virtual ~ Foo(); }; } |
|
max indent |
sets value for indenting a maximum number of spaces in a continuous statement, relative to the previous line |
|
min indent |
sets the minimal indent that is added when a header is built of multiple-lines. This indent helps to easily separate the header from the command statements that follow. The default setting for this option is twice the current indent. // default setting makes this non-bracketed code clear if (a < b || c > d) foo++; // but creates an exaggerated indent in this bracketed code if (a < b || c > d) { foo++; } becomes (when min indent is set to 0): // setting makes this non-bracketed code less clear if (a < b || c > d) foo++; // but makes this bracketed code prettier if (a < b || c > d) { foo++; } |
|
preprocessor |
indents multi-line preprocessor definitions. Should be used with tabs -> spaces for proper results. Although highly satisfactory, this option cannot perform miracles in obfuscated preprocessor definitions. |
|
tab -> spaces |
converts tabs into single spaces |
|
fill empty lines |
fills empty lines with the white space of their previous lines |
Formatting
The following formatting options are available:
|
Control |
Option |
Function |
|
Brackets |
attach |
attaches brackets to their pre-block statements (i.e. Java / K&R style). if ( isFoo) { bar(); } else { baz(); } |
|
break |
breaks brackets from their pre-block statements (i.e. ANSI C / C++ style). if ( isFoo) { bar(); } else { baz(); } |
|
|
break-closing-headers |
breaks closing headers (e.g. 'else', 'catch', ...) from their immediately preceding closing brackets. if ( isFoo) { bar(); } else { anotherBar(); } becomes: if ( isFoo) { bar(); } else { anotherBar(); } |
|
|
linux |
breaks brackets from class/function declarations, but attach brackets to pre-block command statements. namespace foospace { int Foo() { if ( isBar) { bar(); return 1; } else return 0; } } |
|
|
Break Blocks |
Default (no selection) |
pads empty lines around header blocks (e.g. 'if', 'while'...). isFoo = true; if ( isFoo) { bar(); } else { anotherBar(); } isBar = false; becomes: isFoo = true; if ( isFoo) { bar(); } else { anotherBar(); } isBar = false; |
|
All |
pads empty lines around header blocks (e.g. 'if', 'while'...). Treats closing header blocks (e.g. 'else', 'catch') as standalone blocks. isFoo = true; if ( isFoo) { bar(); } else { anotherBar(); } isBar = false; becomes: isFoo = true; if ( isFoo) { bar(); } else { anotherBar(); } isBar = false; |
|
|
Break Else If |
breaks 'else if()' header combinations into separate lines. if ( isFoo) { bar(); } else if ( isBar()) { anotherBar(); } becomes: if ( isFoo) { bar(); } else if ( isBar()) { anotherBar(); } |
|
|
Space Padding |
all |
inserts space padding around operators and parentheses if ( isFoo) a = bar((b-c)*a,* d--); becomes: if ( isFoo ) a = bar( ( b - c ) * a, * d-- ); |
|
oper |
inserts space padding around operators only if ( isFoo) a = bar((b-c)*a,* d--); becomes: if ( isFoo) a = bar((b - c) * a, * d--); |
|
|
paren |
inserts space padding around parentheses only if ( isFoo) a = bar((b-c)*a,* d--); becomes: if ( isFoo ) a = bar( ( b-c )*a, * d-- ); |
|
|
Keep one-line stats. |
doesn't break complex statements and multiple statements residing in a single line if ( isFoo) { isFoo = false; cout << isFoo << endl; } remains as is. if ( isFoo) DoBar(); remains as is. |
|
|
Keep one-line blocks |
doesn't break one-line blocks if ( isFoo) { isFoo = false; cout << isFoo << endl; } remains as is. |
Style
One of five possible styles may be selected using the Style dropdown ( ansi, kr, linux, gnu, java).
|
ansi |
namespace foospace { int Foo() { if ( isBar) { bar(); return 1; } else return 0; } } |
|
kr ( Kernighan&Ritchie) |
namespace foospace { int Foo() { if ( isBar) { bar(); return 1; } else return 0; } } |
|
linux (brackets are broken apart from class/function declarations, but connected to command lines, and indents are set to 8 spaces) |
namespace foospace { int Foo() { if ( isBar) { bar(); return 1; } else return 0; } } |
|
gnu |
namespace foospace { int Foo() { if ( isBar) { bar(); return 1; } else return 0; } } |
|
java |
class foospace { int Foo() { if ( isBar) { bar(); return 1; } else return 0; } } |
Mode
|
c |
indents a C, C++ or C# file |
|
java |
indents a Java file |