clang-format-10 (1) Linux Manual Page
clang-format – manual page for clang-format 10
Description
OVERVIEW: A tool to format C/C++/Java/JavaScript/Objective-C/Protobuf/C# code.If no arguments are specified, it formats the code from standard input and writes the result to the standard output. If <file>s are given, it reformats the files. If -i is specified together with <file>s, the files are edited in-place. Otherwise, the result is written to the standard output.
USAGE: clang-format [options] [<file> …]
OPTIONS:
Clang-format options:
- –Werror – If set, changes formatting warnings to errors
- –assume-filename=<string> – Override filename used to determine the language.
- –assume-filename=<string> – Override filename used to determine the language.
- When reading from stdin, clang-format assumes this filename to determine the language.
- When reading from stdin, clang-format assumes this filename to determine the language.
- –cursor=<uint> – The position of the cursor when invoking
- clang-format from an editor integration
- –dry-run – If set, do not actually make the formatting changes
- –dump-config – Dump configuration options to stdout and exit.
- –dump-config – Dump configuration options to stdout and exit.
- Can be used with -style option.
- Can be used with -style option.
- –fallback-style=<string> – The name of the predefined style used as a
- fallback in case clang-format is invoked with -style=,file/, but can not find the .clang-format file to use. Use -fallback-style=,none/ to skip formatting.
- –ferror-limit=<uint> – Set the maximum number of clang-format errors to emit before stopping (0 = no limit). Used only with –dry-run or -n
- -i – Inplace edit <file>s, if specified.
- –length=<uint> – Format a range of this length (in bytes).
- -i – Inplace edit <file>s, if specified.
- Multiple ranges can be formatted by specifying several -offset and -length pairs. When only a single -offset is specified without -length, clang-format will format up to the end of the file. Can only be used with one input file.
- Multiple ranges can be formatted by specifying several -offset and -length pairs. When only a single -offset is specified without -length, clang-format will format up to the end of the file. Can only be used with one input file.
- –lines=<string> – <start line>:<end line> – format a range of
- lines (both 1-based). Multiple ranges can be formatted by specifying several -lines arguments. Can’t be used with -offset and -length. Can only be used with one input file.
- -n – Alias for –dry-run
- –offset=<uint> – Format a range starting at this byte offset.
- –offset=<uint> – Format a range starting at this byte offset.
- Multiple ranges can be formatted by specifying several -offset and -length pairs. Can only be used with one input file.
- Multiple ranges can be formatted by specifying several -offset and -length pairs. Can only be used with one input file.
- –output-replacements-xml – Output replacements as XML.
- –sort-includes – If set, overrides the include sorting behavior determined by the SortIncludes style flag
- –style=<string> – Coding style, currently supports:
- –sort-includes – If set, overrides the include sorting behavior determined by the SortIncludes style flag
- LLVM, Google, Chromium, Mozilla, WebKit.
- LLVM, Google, Chromium, Mozilla, WebKit.
- Use -style=,file/ to load style configuration from
- .clang-format file located in one of the parent directories of the source file (or current directory for stdin). Use -style="{key: value, …}" to set specific parameters, e.g.:
- -style="{BasedOnStyle: llvm, IndentWidth: 8}"
- -style="{BasedOnStyle: llvm, IndentWidth: 8}"
- –verbose – If set, shows the list of processed files
- –help – Display available options (–help-hidden for more)
- –help-list – Display list of available options (–help-list-hidden for more)
- –version – Display the version of this program
- –help-list – Display list of available options (–help-list-hidden for more)