Configuration of clang-format for QtCreator

clang-format_config.md

QtCreator doesn't allow using clang-format by default. Watch QTCREATORBUG-10111 for a better integration. For now, you should use it as an external tool, either replacing your selection (described below) or the entire file.

For Windows, download LLVM from http://llvm.org/builds/. You don't need to add it to the PATH, you can use it with the absolute path.

In QtCreator, add an external tool (Tools > Options... > Environment > External Tools > Add > Add Tool).

• Arguments: -style="{BasedOnStyle: llvm, ColumnLimit: 80, Standard: Cpp11, IndentWidth: 4, BreakBeforeBraces: Linux}"
• Working dir: %{CurrentProject:Path}
• Output: replace selection
• Error output: show in pane
• Don't tick the "Modifies current document"
• Input: %{CurrentDocument:Selection}

See these for all possible parameters:

• http://clang.llvm.org/doxygen/structclang_1_1format_1_1FormatStyle.html
• http://clang.llvm.org/docs/ClangFormat.html

Thank you! It works nicely.

Thanks! This definitely put me on the right track!
However, for the beautifier entry to appear within the Tools->Options the Beautifier plugin must be enabled first. With version 3.5.x it's still not enabled by default.
Enabeling can be done via Help -> About Plugins.
Ctrl+Shift+I collides with Open Include History (on QtCreator-Linux at least). I've tied this to Ctrl+Alt+I.
Also, if you want to modify the default styles, check [X] Use customized styles.
In the dialog appearing when clicking add just set a name of your choice and within the value field, add a comma separated list of options. e.g.
BasedOnStyle: llvm, ColumnLimit: 100, IndentWidth: 4, Standard: Cpp11, PointerBindsToType: false, BreakBeforeBraces: Linux, BreakConstructorInitializersBeforeComma: true, AccessModifierOffset: -4, BreakBeforeBinaryOperators: true ...
I've found (http://clangformat.com/) quite useful for explaining the options.

Thank you!

Thank you! *2

nice~