EditorConfig properties for C++: Braces Layout

Last modified: 26 May 2024

tip

Formatting preferences listed on this page can be also configured visually, on the Editor | Code Style | C++ | Braces Layout page of JetBrains Rider settings .

Braces layout

Namespace declaration

Property names:

[resharper_]cpp_namespace_declaration_braces, [resharper_]cpp_brace_style, [resharper_]namespace_declaration_braces, [resharper_]brace_style

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

namespace ns {
	void a();
}

end_of_line_no_space

namespace ns{
	void a();
}

next_line

namespace ns
{
	void a();
}

next_line_shifted

namespace ns
	{
	void a();
	}

next_line_shifted_2

namespace ns
	{
		void a();
	}

Linkage specifications

Property names:

[resharper_]cpp_linkage_specification_braces, [resharper_]cpp_brace_style, [resharper_]linkage_specification_braces, [resharper_]brace_style

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

extern "C++" {
void a();
}

end_of_line_no_space

extern "C++"{
void a();
}

next_line

extern "C++"
{
void a();
}

next_line_shifted

extern "C++"
	{
void a();
	}

next_line_shifted_2

extern "C++"
	{
	void a();
	}

Export declarations

Property names:

[resharper_]cpp_export_declaration_braces, [resharper_]cpp_brace_style, [resharper_]export_declaration_braces, [resharper_]brace_style

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

export {
	void a();
}

end_of_line_no_space

export{
	void a();
}

next_line

export
{
	void a();
}

next_line_shifted

export
	{
	void a();
	}

next_line_shifted_2

export
	{
		void a();
	}

Type declaration

Property names:

[resharper_]cpp_type_declaration_braces, [resharper_]cpp_brace_style, [resharper_]type_declaration_braces, [resharper_]brace_style

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

class C {
public:
	void a();
};

end_of_line_no_space

class C{
public:
	void a();
};

next_line

class C
{
public:
	void a();
};

next_line_shifted

class C
	{
public:
	void a();
	};

next_line_shifted_2

class C
	{
	public:
		void a();
	};

Place namespace definitions on the same line

Property names:

[resharper_]cpp_place_namespace_definitions_on_same_line, [resharper_]place_namespace_definitions_on_same_line

Possible values:

true | false

Examples:

true

namespace A { namespace B
{
	void a();
}}

false

namespace A
{
	namespace B
	{
		void a();
	}
}

Function declaration

Property names:

[resharper_]cpp_invocable_declaration_braces, [resharper_]cpp_brace_style, [resharper_]invocable_declaration_braces, [resharper_]brace_style

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

void a() {
	b();
}

end_of_line_no_space

void a(){
	b();
}

next_line

void a()
{
	b();
}

next_line_shifted

void a()
	{
	b();
	}

next_line_shifted_2

void a()
	{
		b();
	}

Lambda expression

Property names:

[resharper_]cpp_anonymous_method_declaration_braces, [resharper_]cpp_brace_style, [resharper_]anonymous_method_declaration_braces, [resharper_]brace_style

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

auto a = []() {
	int x = 0;
	return x;
};

end_of_line_no_space

auto a = [](){
	int x = 0;
	return x;
};

next_line

auto a = []()
{
	int x = 0;
	return x;
};

next_line_shifted

auto a = []()
	{
	int x = 0;
	return x;
	};

next_line_shifted_2

auto a = []()
	{
		int x = 0;
		return x;
	};

Block under 'case' label

Property names:

[resharper_]cpp_case_block_braces, [resharper_]cpp_brace_style, [resharper_]case_block_braces, [resharper_]brace_style

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

switch (expression)
{
case 0: {
	foo();
	break;
}
}

end_of_line_no_space

switch (expression)
{
case 0: {
	foo();
	break;
}
}

next_line

switch (expression)
{
case 0:
{
	foo();
	break;
}
}

next_line_shifted

switch (expression)
{
case 0:
	{
	foo();
	break;
	}
}

next_line_shifted_2

switch (expression)
{
case 0:
	{
		foo();
		break;
	}
}

Requires expressions

Property names:

[resharper_]cpp_requires_expression_braces, [resharper_]requires_expression_braces

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

template <typename T> concept C = requires {
	typename T::inner1; typename T::inner2;
};

end_of_line_no_space

template <typename T> concept C = requires{
	typename T::inner1; typename T::inner2;
};

next_line

template <typename T> concept C = requires
{
	typename T::inner1; typename T::inner2;
};

next_line_shifted

template <typename T> concept C = requires
	{
	typename T::inner1; typename T::inner2;
	};

next_line_shifted_2

template <typename T> concept C = requires
	{
		typename T::inner1; typename T::inner2;
	};

Other statements and blocks

Property names:

[resharper_]cpp_other_braces, [resharper_]cpp_brace_style, [resharper_]other_braces, [resharper_]brace_style

Possible values:

  • end_of_line: At the end of line (K&R style)

  • end_of_line_no_space: At the end of line (no space)

  • next_line: At next line (BSD style)

  • next_line_shifted: At next line indented (Whitesmiths style)

  • next_line_shifted_2: At next line indented 2 (GNU style)

Examples:

end_of_line

if (condition) {
	foo();
}
else {
	foo();
}

end_of_line_no_space

if (condition){
	foo();
}
else{
	foo();
}

next_line

if (condition)
{
	foo();
}
else
{
	foo();
}

next_line_shifted

if (condition)
	{
	foo();
	}
else
	{
	foo();
	}

next_line_shifted_2

if (condition)
	{
		foo();
	}
else
	{
		foo();
	}

Other braces

Property names:

[resharper_]cpp_expression_braces, [resharper_]expression_braces

Possible values:

  • inside: Inside parenthesis (BSD/K&R style)

  • outside: Parenthesis and inside equally (Whitesmiths style)

  • outside_and_inside: Parenthesis 1x, inside 2x (GNU style)

  • none: No indent

Examples:

inside

int a[10] =
{
	1, 2, 3
};

outside

int a[10] =
	{
	1, 2, 3
	};

outside_and_inside

int a[10] =
	{
		1, 2, 3
	};

none

int a[10] =
{
1, 2, 3
};

Empty braces formatting

Property names:

[resharper_]cpp_empty_block_style, [resharper_]empty_block_style

Possible values:

  • multiline: On different lines

  • together: Place braces together

  • together_same_line: Together on the same line

Examples:

multiline

class C
{
};

void foo()
{
	for (;;)
	{
	}
}

together

class C
{};

void foo()
{
	for (;;) {}
}

together_same_line

class C {};

void foo()
{
	for (;;) {}
}

Keep simple compound statements in one line

Property names:

[resharper_]cpp_simple_block_style, [resharper_]simple_block_style

Possible values:

  • do_not_change: Do not change

  • on_single_line: Force put on single line

  • line_break: Force line breaks

Examples:

do_not_change

int foo() { return 0; }

on_single_line

int foo() { return 0; }

line_break

int foo()
{
	return 0;
}

Regular expression for macros starting a block

Property names:

[resharper_]cpp_macro_block_begin, [resharper_]macro_block_begin

Regular expression for macros ending a block

Property names:

[resharper_]cpp_macro_block_end, [resharper_]macro_block_end

Allow comment after '{'

Property names:

[resharper_]cpp_allow_comment_after_lbrace, [resharper_]allow_comment_after_lbrace

Possible values:

true | false

Examples:

true

if (condition)
{ // comment
	statement;
}

false

if (condition)
{
	// comment
	statement;
}