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" (this will ask you to save the document before running the tool and should be ticked if you want to update the whole file instead of only the selection)
• Input: %{CurrentDocument:Selection}

See these for all possible parameters and enum values (that are not listed in the -help option):

• 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~