4.3. Printer

Lets you control all printer related settings.

4.3.1. Braces

Controls the handling of curly braces (the Java block delimeters).

4.3.1.1. General

Controls how the enclosing block delimeters - left and right curly brace - are printed. You can either choose from a predefined set of common styles or build one on your own.

4.3.1.1.2. Wrapping

Controls the brace wrapping options.

Newline before left brace

If enabled, always prints a newline before the left curly brace.

Newline after right brace

If enabled, prints a newline after the left curly brace (when possible).

Treat class/method blocks different

It is common in the Java developer community to have the opening brace at the end of the line of the keyword for all types of blocks (Sun brace style). One may find the C++ convention of treating class/interface and method/constructor blocks different from other blocks useful. With this switch you can achieve exactly that: if enabled, class/interface and method/constructor blocks are then always printed in C brace style (newline before left brace).

Treat class/method blocks different if wrapped

With this switch enabled, the opening brace for class/interface or method/constructor blocks will always be printed on a new line (C style), if either the parameter list spawns several lines and a throws clause follows, or one of the possible clauses (extends, implements, throws) was wrapped.

4.3.1.1.3. Whitespace

Controls the indentation whitespace for the left and right curly brace.

Before left brace

Number of spaces to print before the left curly brace.
After left brace

Number of spaces to print after the left curly brace.
After right brace

Number of spaces to print after the right curly brace.

4.3.1.2. Misc

Controls miscellaneous brace options.

4.3.1.2.1. Insert braces

Per definition braces are superfluous on single statements, but it is a common recommendation that braces should be always used in such cases. With this option, you can specify whether missing braces for single statements should be inserted for the control statements if, for, while and do-while.

Enabling this option for while statements would render

Example 4.4. Brace insertion

while (!isDone)
    doSomething();

into

while (!isDone)
{
    doSomething();
}

4.3.1.2.2. Remove braces

It is permittable to remove braces in case they are superfluous. This not only applies to the control statements if, for, while and do-while, but also to every block in general (remember a block is just a sequence of statements, local class declarations and local variable declaration statements within braces).

Example 4.5. Brace removal

for (int i = 0; i < 100; i++)
{
    sum += value[i];
}

would become

for (int i = 0; i < 100; i++)
    sum += value[i];

4.3.1.2.3. Empty braces

Controls how empty braces should be handled. If no option is selected, they are left untouched.

Example 4.6. Empty braces

if (in != null)
{
    try
    {
        in.close();
    }
    catch (IOException ignored)
    {
    }
}

All options don't apply to class/interface and method/constructor bodies but are only used for control statements and blocks.

Insert empty statement

Inserts an empty statement to make it obvious for the reader that the empty braces are intentional.
Example 4.7. Empty braces with empty statement
```
if (in != null)
{
    try
    {
        in.close();
    }
    catch (IOException ignored)
    {
        ;
    }
}
```

Cuddle braces

Cuddles the braces. They will be printed right after the control statement.

Example 4.8. Cuddled empty braces

if (in != null) { try { in.close(); } catch (IOException ignored) {} }