clang-format

LLVM's formatter for C and its family, in its LLVM style.

Formats
C, C++
In ur.toml
[format] style = "clang-format"
Its options
https://clang.llvm.org/docs/ClangFormatStyleOptions.html

C, formatted

cart.c, as written
#include <stddef.h>
/* What a cart costs. */
struct item { const char *name; int price; int quantity; };
int subtotal(const struct item *items, size_t count)
{
    int sum=0;
    for(size_t i=0;i<count;i++) sum+=items[i].price*items[i].quantity;
    return sum;
}
ur format --style clang-format cart.c
#include <stddef.h>
/* What a cart costs. */
struct item {
  const char *name;
  int price;
  int quantity;
};
int subtotal(const struct item *items, size_t count) {
  int sum = 0;
  for (size_t i = 0; i < count; i++)
    sum += items[i].price * items[i].quantity;
  return sum;
}

Try it in the playground →

C++, formatted

cart.cpp, as written
#include <vector>
// What a cart costs.
namespace cart {
struct Item { int price; int quantity; };
int subtotal(const std::vector<Item> & items){
    int sum=0;
    for(const Item & item:items) sum+=item.price*item.quantity;
    return sum;
}
} // namespace cart
ur format --style clang-format cart.cpp
#include <vector>
// What a cart costs.
namespace cart {
struct Item {
  int price;
  int quantity;
};
int subtotal(const std::vector<Item> &items) {
  int sum = 0;
  for (const Item &item : items)
    sum += item.price * item.quantity;
  return sum;
}
} // namespace cart

Try it in the playground →

Defaults

The shared options, as clang-format sets them when nothing configures it. Its own names for them are read from its configuration files, but ur.toml sets them by the shared name only.

OptionDefaultclang-format calls it
width80ColumnLimit
max-width
indent.width2IndentWidth
indent.style
line-ending"auto"
trailing-comma.add"preserve"
trailing-comma.forces-breakfalse
quotes"preserve"
target

Its own options

Set in a table named for it, such as [format.clang-format], or in a language's table, as clang-format = { ... }.

OptionDefaultValues
BasedOnStyle"LLVM"any value
AlignAfterOpenBrackettrueany value
AccessModifierOffset-2any value
AlignArrayOfStructures"None"any value
AlignConsecutiveAssignments.Enabledfalseany value
AlignConsecutiveAssignments.AcrossEmptyLinesfalseany value
AlignConsecutiveAssignments.AcrossCommentsfalseany value
AlignConsecutiveAssignments.AlignCompoundfalseany value
AlignConsecutiveAssignments.AlignFunctionDeclarationsfalseany value
AlignConsecutiveAssignments.AlignFunctionPointersfalseany value
AlignConsecutiveAssignments.PadOperatorstrueany value
AlignConsecutiveBitFields.Enabledfalseany value
AlignConsecutiveBitFields.AcrossEmptyLinesfalseany value
AlignConsecutiveBitFields.AcrossCommentsfalseany value
AlignConsecutiveBitFields.AlignCompoundfalseany value
AlignConsecutiveBitFields.AlignFunctionDeclarationsfalseany value
AlignConsecutiveBitFields.AlignFunctionPointersfalseany value
AlignConsecutiveBitFields.PadOperatorsfalseany value
AlignConsecutiveDeclarations.Enabledfalseany value
AlignConsecutiveDeclarations.AcrossEmptyLinesfalseany value
AlignConsecutiveDeclarations.AcrossCommentsfalseany value
AlignConsecutiveDeclarations.AlignCompoundfalseany value
AlignConsecutiveDeclarations.AlignFunctionDeclarationstrueany value
AlignConsecutiveDeclarations.AlignFunctionPointersfalseany value
AlignConsecutiveDeclarations.PadOperatorsfalseany value
AlignConsecutiveMacros.Enabledfalseany value
AlignConsecutiveMacros.AcrossEmptyLinesfalseany value
AlignConsecutiveMacros.AcrossCommentsfalseany value
AlignConsecutiveMacros.AlignCompoundfalseany value
AlignConsecutiveMacros.AlignFunctionDeclarationsfalseany value
AlignConsecutiveMacros.AlignFunctionPointersfalseany value
AlignConsecutiveMacros.PadOperatorsfalseany value
AlignConsecutiveShortCaseStatements.Enabledfalseany value
AlignConsecutiveShortCaseStatements.AcrossEmptyLinesfalseany value
AlignConsecutiveShortCaseStatements.AcrossCommentsfalseany value
AlignConsecutiveShortCaseStatements.AlignCaseArrowsfalseany value
AlignConsecutiveShortCaseStatements.AlignCaseColonsfalseany value
AlignConsecutiveTableGenBreakingDAGArgColons.Enabledfalseany value
AlignConsecutiveTableGenBreakingDAGArgColons.AcrossEmptyLinesfalseany value
AlignConsecutiveTableGenBreakingDAGArgColons.AcrossCommentsfalseany value
AlignConsecutiveTableGenBreakingDAGArgColons.AlignCompoundfalseany value
AlignConsecutiveTableGenBreakingDAGArgColons.AlignFunctionDeclarationsfalseany value
AlignConsecutiveTableGenBreakingDAGArgColons.AlignFunctionPointersfalseany value
AlignConsecutiveTableGenBreakingDAGArgColons.PadOperatorsfalseany value
AlignConsecutiveTableGenCondOperatorColons.Enabledfalseany value
AlignConsecutiveTableGenCondOperatorColons.AcrossEmptyLinesfalseany value
AlignConsecutiveTableGenCondOperatorColons.AcrossCommentsfalseany value
AlignConsecutiveTableGenCondOperatorColons.AlignCompoundfalseany value
AlignConsecutiveTableGenCondOperatorColons.AlignFunctionDeclarationsfalseany value
AlignConsecutiveTableGenCondOperatorColons.AlignFunctionPointersfalseany value
AlignConsecutiveTableGenCondOperatorColons.PadOperatorsfalseany value
AlignConsecutiveTableGenDefinitionColons.Enabledfalseany value
AlignConsecutiveTableGenDefinitionColons.AcrossEmptyLinesfalseany value
AlignConsecutiveTableGenDefinitionColons.AcrossCommentsfalseany value
AlignConsecutiveTableGenDefinitionColons.AlignCompoundfalseany value
AlignConsecutiveTableGenDefinitionColons.AlignFunctionDeclarationsfalseany value
AlignConsecutiveTableGenDefinitionColons.AlignFunctionPointersfalseany value
AlignConsecutiveTableGenDefinitionColons.PadOperatorsfalseany value
AlignEscapedNewlines"Right"any value
AlignOperands"Align"any value
AlignTrailingComments.AlignPPAndNotPPtrueany value
AlignTrailingComments.Kind"Always"any value
AlignTrailingComments.OverEmptyLines0any value
AllowAllArgumentsOnNextLinetrueany value
AllowAllParametersOfDeclarationOnNextLinetrueany value
AllowBreakBeforeNoexceptSpecifier"Never"any value
AllowBreakBeforeQtPropertyfalseany value
AllowShortBlocksOnASingleLine"Never"any value
AllowShortCaseExpressionOnASingleLinetrueany value
AllowShortCaseLabelsOnASingleLinefalseany value
AllowShortCompoundRequirementOnASingleLinetrueany value
AllowShortEnumsOnASingleLinetrueany value
AllowShortFunctionsOnASingleLine"All"any value
AllowShortIfStatementsOnASingleLine"Never"any value
AllowShortLambdasOnASingleLine"All"any value
AllowShortLoopsOnASingleLinefalseany value
AllowShortNamespacesOnASingleLinefalseany value
AlwaysBreakAfterDefinitionReturnType"None"any value
AlwaysBreakBeforeMultilineStringsfalseany value
AttributeMacros["__capability"]any value
BinPackArgumentstrueany value
BinPackLongBracedListtrueany value
BinPackParameters"BinPack"any value
BitFieldColonSpacing"Both"any value
BracedInitializerIndentWidth-1any value
BraceWrapping.AfterCaseLabelfalseany value
BraceWrapping.AfterClassfalseany value
BraceWrapping.AfterControlStatement"Never"any value
BraceWrapping.AfterEnumfalseany value
BraceWrapping.AfterExternBlockfalseany value
BraceWrapping.AfterFunctionfalseany value
BraceWrapping.AfterNamespacefalseany value
BraceWrapping.AfterObjCDeclarationfalseany value
BraceWrapping.AfterStructfalseany value
BraceWrapping.AfterUnionfalseany value
BraceWrapping.BeforeCatchfalseany value
BraceWrapping.BeforeElsefalseany value
BraceWrapping.BeforeLambdaBodyfalseany value
BraceWrapping.BeforeWhilefalseany value
BraceWrapping.IndentBracesfalseany value
BraceWrapping.SplitEmptyFunctiontrueany value
BraceWrapping.SplitEmptyRecordtrueany value
BraceWrapping.SplitEmptyNamespacetrueany value
BreakAdjacentStringLiteralstrueany value
BreakAfterAttributes"Leave"any value
BreakAfterJavaFieldAnnotationsfalseany value
BreakAfterOpenBracketBracedListfalseany value
BreakAfterOpenBracketFunctionfalseany value
BreakAfterOpenBracketIffalseany value
BreakAfterOpenBracketLoopfalseany value
BreakAfterOpenBracketSwitchfalseany value
BreakAfterReturnType"None"any value
BreakArraystrueany value
BreakBeforeBinaryOperators"None"any value
BreakBeforeCloseBracketBracedListfalseany value
BreakBeforeCloseBracketFunctionfalseany value
BreakBeforeCloseBracketIffalseany value
BreakBeforeCloseBracketLoopfalseany value
BreakBeforeCloseBracketSwitchfalseany value
BreakBeforeConceptDeclarations"Always"any value
BreakBeforeBraces"Attach"any value
BreakBeforeInlineASMColon"OnlyMultiline"any value
BreakBeforeTemplateCloserfalseany value
BreakBeforeTernaryOperatorstrueany value
BreakBinaryOperations"Never"any value
BreakConstructorInitializers"BeforeColon"any value
BreakFunctionDefinitionParametersfalseany value
BreakInheritanceList"BeforeColon"any value
BreakStringLiteralstrueany value
BreakTemplateDeclarations"MultiLine"any value
CommentPragmas"^ IWYU pragma:"any value
CompactNamespacesfalseany value
ConstructorInitializerIndentWidth4any value
ContinuationIndentWidth4any value
Cpp11BracedListStyle"AlignFirstComment"any value
DerivePointerAlignmentfalseany value
DisableFormatfalseany value
EmptyLineAfterAccessModifier"Never"any value
EmptyLineBeforeAccessModifier"LogicalBlock"any value
EnumTrailingComma"Leave"any value
ExperimentalAutoDetectBinPackingfalseany value
FixNamespaceCommentstrueany value
ForEachMacros["foreach","Q_FOREACH","BOOST_FOREACH"]any value
IfMacros["KJ_IF_MAYBE"]any value
IncludeBlocks"Preserve"any value
IncludeCategories[{"Regex":"^\"(llvm|llvm-c|clang|clang-c)/","Priority":2,"SortPriority":0,"CaseSensitive":false},{"Regex":"^(<|\"(gtest|gmock|isl|json)/)","Priority":3,"SortPriority":0,"CaseSensitive":false},{"Regex":".*","Priority":1,"SortPriority":0,"CaseSensitive":false}]any value
IncludeIsMainRegex"(Test)?$"any value
IncludeIsMainSourceRegex""any value
IndentAccessModifiersfalseany value
IndentCaseBlocksfalseany value
IndentCaseLabelsfalseany value
IndentExportBlocktrueany value
IndentExternBlock"AfterExternBlock"any value
IndentGotoLabelstrueany value
IndentPPDirectives"None"any value
IndentRequiresClausetrueany value
IndentWrappedFunctionNamesfalseany value
InsertBracesfalseany value
InsertNewlineAtEOFfalseany value
InsertTrailingCommas"None"any value
IntegerLiteralSeparator.Binary0any value
IntegerLiteralSeparator.BinaryMinDigitsInsert0any value
IntegerLiteralSeparator.BinaryMaxDigitsRemove0any value
IntegerLiteralSeparator.Decimal0any value
IntegerLiteralSeparator.DecimalMinDigitsInsert0any value
IntegerLiteralSeparator.DecimalMaxDigitsRemove0any value
IntegerLiteralSeparator.Hex0any value
IntegerLiteralSeparator.HexMinDigitsInsert0any value
IntegerLiteralSeparator.HexMaxDigitsRemove0any value
IntegerLiteralSeparator.BinaryMinDigits0any value
IntegerLiteralSeparator.DecimalMinDigits0any value
IntegerLiteralSeparator.HexMinDigits0any value
JavaScriptQuotes"Leave"any value
JavaScriptWrapImportstrueany value
KeepEmptyLines.AtEndOfFilefalseany value
KeepEmptyLines.AtStartOfBlocktrueany value
KeepEmptyLines.AtStartOfFiletrueany value
KeepFormFeedfalseany value
LambdaBodyIndentation"Signature"any value
LineEnding"DeriveLF"any value
MacroBlockBegin""any value
MacroBlockEnd""any value
MainIncludeChar"Quote"any value
MaxEmptyLinesToKeep1any value
NamespaceIndentation"None"any value
NumericLiteralCase.ExponentLetter"Leave"any value
NumericLiteralCase.HexDigit"Leave"any value
NumericLiteralCase.Prefix"Leave"any value
NumericLiteralCase.Suffix"Leave"any value
ObjCBinPackProtocolList"Auto"any value
ObjCBlockIndentWidth2any value
ObjCBreakBeforeNestedBlockParamtrueany value
ObjCSpaceAfterPropertyfalseany value
ObjCSpaceBeforeProtocolListtrueany value
OneLineFormatOffRegex""any value
PackConstructorInitializers"BinPack"any value
PenaltyBreakAssignment2any value
PenaltyBreakBeforeFirstCallParameter19any value
PenaltyBreakBeforeMemberAccess150any value
PenaltyBreakComment300any value
PenaltyBreakFirstLessLess120any value
PenaltyBreakOpenParenthesis0any value
PenaltyBreakScopeResolution500any value
PenaltyBreakString1000any value
PenaltyBreakTemplateDeclaration10any value
PenaltyExcessCharacter1000000any value
PenaltyIndentedWhitespace0any value
PenaltyReturnTypeOnItsOwnLine60any value
PointerAlignment"Right"any value
PPIndentWidth-1any value
QualifierAlignment"Leave"any value
ReferenceAlignment"Pointer"any value
ReflowComments"Always"any value
RemoveBracesLLVMfalseany value
RemoveEmptyLinesInUnwrappedLinesfalseany value
RemoveParentheses"Leave"any value
RemoveSemicolonfalseany value
RequiresClausePosition"OwnLine"any value
RequiresExpressionIndentation"OuterScope"any value
SeparateDefinitionBlocks"Leave"any value
ShortNamespaceLines1any value
SkipMacroDefinitionBodyfalseany value
SortIncludes.Enabledtrueany value
SortIncludes.IgnoreCasefalseany value
SortIncludes.IgnoreExtensionfalseany value
SortJavaStaticImport"Before"any value
SortUsingDeclarations"LexicographicNumeric"any value
SpaceAfterCStyleCastfalseany value
SpaceAfterLogicalNotfalseany value
SpaceAfterOperatorKeywordfalseany value
SpaceAfterTemplateKeywordtrueany value
SpaceAroundPointerQualifiers"Default"any value
SpaceBeforeAssignmentOperatorstrueany value
SpaceBeforeCaseColonfalseany value
SpaceBeforeCpp11BracedListfalseany value
SpaceBeforeCtorInitializerColontrueany value
SpaceBeforeInheritanceColontrueany value
SpaceBeforeJsonColonfalseany value
SpaceBeforeParens"ControlStatements"any value
SpaceBeforeParensOptions.AfterControlStatementstrueany value
SpaceBeforeParensOptions.AfterForeachMacrostrueany value
SpaceBeforeParensOptions.AfterFunctionDefinitionNamefalseany value
SpaceBeforeParensOptions.AfterFunctionDeclarationNamefalseany value
SpaceBeforeParensOptions.AfterIfMacrostrueany value
SpaceBeforeParensOptions.AfterNotfalseany value
SpaceBeforeParensOptions.AfterOverloadedOperatorfalseany value
SpaceBeforeParensOptions.AfterPlacementOperatortrueany value
SpaceBeforeParensOptions.AfterRequiresInClausefalseany value
SpaceBeforeParensOptions.AfterRequiresInExpressionfalseany value
SpaceBeforeParensOptions.BeforeNonEmptyParenthesesfalseany value
SpaceBeforeRangeBasedForLoopColontrueany value
SpaceBeforeSquareBracketsfalseany value
SpaceInEmptyBraces"Never"any value
SpacesBeforeTrailingComments1any value
SpacesInAngles"Never"any value
SpacesInContainerLiteralstrueany value
SpacesInLineCommentPrefix.Minimum1any value
SpacesInLineCommentPrefix.Maximum-1any value
SpacesInParens"Never"any value
SpacesInParensOptions.ExceptDoubleParenthesesfalseany value
SpacesInParensOptions.InCStyleCastsfalseany value
SpacesInParensOptions.InConditionalStatementsfalseany value
SpacesInParensOptions.InEmptyParenthesesfalseany value
SpacesInParensOptions.Otherfalseany value
SpacesInSquareBracketsfalseany value
Standard"Latest"any value
StatementAttributeLikeMacros["Q_EMIT"]any value
StatementMacros["Q_UNUSED","QT_REQUIRE_VERSION"]any value
TableGenBreakInsideDAGArg"DontBreak"any value
TabWidth8any value
UseTab"Never"any value
VerilogBreakBetweenInstancePortstrueany value
WhitespaceSensitiveMacros["BOOST_PP_STRINGIZE","CF_SWIFT_NAME","NS_SWIFT_NAME","PP_STRINGIZE","STRINGIZE"]any value
WrapNamespaceBodyWithEmptyLines"Leave"any value