.clang-format

# Based on the LLVM coding style https://llvm.org/docs/CodingStandards.html
BasedOnStyle: LLVM

# Always add a line break after an opening bracket if the parameters
# do not fit on a single line
AlignAfterOpenBracket: AlwaysBreak

# If arguments don't all fit on a single line, place each one in
# a new line
BinPackArguments: false

# If a function call or braced initializer list does not fit on a
# line, allow putting all arguments onto the next line
# (even if BinPackArguments is false).
AllowAllArgumentsOnNextLine: false

# If parameters don't all fit on a single line, place each one in
# a new line
BinPackParameters: false

# If the function declaration does not fit on a line, allow putting
# all parameters of a function declaration onto the next line
# (even when BinPackParameters is false).
AllowAllParametersOfDeclarationOnNextLine: false

# Use 'int* a;' (instead of 'int *a;')
PointerAlignment: Left

# If the constructor initializers doe not fit on a line, put each
# initializer on its own line.
ConstructorInitializerAllOnOneLineOrOnePerLine: true

# Do not break comment lines that contain the given regex. This
# is here to avoid breaking lines within "{@link SomeClass}"
# which would cause doxygen to fail.
CommentPragmas: '{.*}'

# Disregard any exising include order, and re-order the headers
# to use the following order based on the include path regexes:
IncludeBlocks: Regroup
IncludeCategories:
  # Local includes, enclosed in quotation marks, ending in `.h`
  - Regex: '"[A-Za-z0-9.+_\/\-]+\.h"'
    Priority: 1
  # Third party includes, of the form `<something/something>` or `<something.h>`
  - Regex: '(<[A-Za-z0-9_\/\-]+\/[A-Za-z0-9_\/\-\.]+>)|(<[A-Za-z0-9+_\/\-]+\.h>)'
    Priority: 2
  # Standard library includes, of the form `<something>
  - Regex: '<[A-Za-z0-9_]+>'
    Priority: 3