xref: /AliOS-Things-master/components/py_engine/engine/tools/uncrustify.cfg

59 # Add or remove the UTF-8 BOM (recommend 'remove').
69 # Add or remove space between 'do' and '{'.
72 # Add or remove space between '}' and 'while'.
75 # Add or remove space between 'while' and '('.
82 # Add or remove space around non-assignment symbolic operators ('+', '/', '%',
86 # Add or remove space around arithmetic operators '+' and '-'.
91 # Add or remove space around assignment operator '=', '+=', etc.
94 # Add or remove space around '=' in C++11 lambda capture specifications.
99 # Add or remove space after the capture specification of a C++11 lambda when
103 # Add or remove space after the capture specification of a C++11 lambda with
107 # Add or remove space after the argument list of a C++11 lambda, as in
111 # Add or remove space between a lambda body and its call operator of an
115 # Add or remove space around assignment operator '=' in a prototype.
120 # Add or remove space before assignment operator '=', '+=', etc.
125 # Add or remove space after assignment operator '=', '+=', etc.
130 # Add or remove space in 'NS_ENUM ('.
133 # Add or remove space around assignment '=' in enum.
136 # Add or remove space before assignment '=' in enum.
141 # Add or remove space after assignment '=' in enum.
146 # Add or remove space around assignment ':' in enum.
149 # Add or remove space around preprocessor '##' concatenation operator.
154 # Add or remove space after preprocessor '#' stringify operator.
158 # Add or remove space before preprocessor '#' stringify operator
162 # Add or remove space around boolean operators '&&' and '||'.
165 # Add or remove space around compare operator '<', '>', '==', etc.
168 # Add or remove space inside '(' and ')'.
171 # Add or remove space between nested parentheses, i.e. '((' vs. ') )'.
174 # Add or remove space between back-to-back parentheses, i.e. ')(' vs. ') ('.
180 # Add or remove space between ')' and '{'.
183 # Add or remove space between nested braces, i.e. '{{' vs '{ {'.
186 # Add or remove space before pointer star '*'.
189 # Add or remove space before pointer star '*' that isn't followed by a
193 # Add or remove space between pointer stars '*'.
196 # Add or remove space after pointer star '*', if followed by a word.
201 # Add or remove space after pointer caret '^', if followed by a word.
204 # Add or remove space after pointer star '*', if followed by a qualifier.
207 # Add or remove space after a pointer star '*', if followed by a function
213 # Add or remove space after a pointer star '*', if followed by an open
217 # Add or remove space before a pointer star '*', if followed by a function
221 # Add or remove space before a reference sign '&'.
224 # Add or remove space before a reference sign '&' that isn't followed by a
228 # Add or remove space after reference sign '&', if followed by a word.
233 # Add or remove space after a reference sign '&', if followed by a function
239 # Add or remove space before a reference sign '&', if followed by a function
243 # Add or remove space between type and word.
248 # Add or remove space between 'decltype(...)' and word.
251 # (D) Add or remove space before the parenthesis in the D constructs
255 # Add or remove space between 'template' and '<'.
259 # Add or remove space before '<'.
262 # Add or remove space inside '<' and '>'.
265 # Add or remove space inside '<>'.
268 # Add or remove space between '>' and ':'.
271 # Add or remove space after '>'.
274 # Add or remove space between '>' and '(' as found in 'new List<byte>(foo);'.
277 # Add or remove space between '>' and '()' as found in 'new List<byte>();'.
280 # Add or remove space between '>' and a word as in 'List<byte> m;' or
284 # Add or remove space between '>' and '>' in '>>' (template stuff).
293 # Add or remove space before '(' of control statements ('if', 'for', 'switch',
297 # Add or remove space inside '(' and ')' of control statements.
300 # Add or remove space after '(' of control statements.
305 # Add or remove space before ')' of control statements.
310 # Add or remove space after ')' of control statements.
313 # Add or remove space between ')' and '{' of of control statements.
316 # (D) Add or remove space between 'invariant' and '('.
319 # (D) Add or remove space after the ')' in 'invariant (C) c'.
322 # Add or remove space before empty statement ';' on 'if', 'for' and 'while'.
325 # Add or remove space before ';'.
330 # Add or remove space before ';' in non-empty 'for' statements.
333 # Add or remove space before a semicolon of an empty part of a for statement.
336 # Add or remove space after ';', except when followed by a comment.
341 # Add or remove space after ';' in non-empty 'for' statements.
346 # Add or remove space after the final semicolon of an empty part of a for
350 # Add or remove space before '[' (except '[]').
353 # Add or remove space before '[' for a variable definition.
358 # Add or remove space before '[' for asm block.
361 # Add or remove space before '[]'.
364 # Add or remove space before C++17 structured bindings.
367 # Add or remove space inside a non-empty '[' and ']'.
370 # (OC) Add or remove space inside a non-empty Objective-C boxed array '@[' and
374 # Add or remove space after ',', i.e. 'a,b' vs. 'a, b'.
377 # Add or remove space before ','.
382 # (C#) Add or remove space between ',' and ']' in multidimensional array type
386 # (C#) Add or remove space between '[' and ',' in multidimensional array type
390 # (C#) Add or remove space between ',' in multidimensional array type
394 # Add or remove space between an open parenthesis and comma,
400 # Add or remove space before the variadic '...' when preceded by a
404 # Add or remove space between a type and '...'.
407 # (D) Add or remove space between a type and '?'.
410 # Add or remove space between ')' and '...'.
413 # Add or remove space between ')' and a qualifier such as 'const'.
416 # Add or remove space between ')' and 'noexcept'.
419 # Add or remove space after class ':'.
422 # Add or remove space before class ':'.
425 # Add or remove space after class constructor ':'.
428 # Add or remove space before class constructor ':'.
431 # Add or remove space before case ':'.
436 # Add or remove space between 'operator' and operator sign.
439 # Add or remove space between the operator symbol and the open parenthesis, as
447 # Add or remove space after C/D cast, i.e. 'cast(int)a' vs. 'cast(int) a' or
451 # Add or remove spaces inside cast parentheses.
454 # Add or remove space between the type and open parenthesis in a C++ cast,
458 # Add or remove space between 'sizeof' and '('.
461 # Add or remove space between 'sizeof' and '...'.
464 # Add or remove space between 'sizeof...' and '('.
467 # Add or remove space between 'decltype' and '('.
470 # (Pawn) Add or remove space after the tag keyword.
473 # Add or remove space inside enum '{' and '}'.
476 # Add or remove space inside struct/union '{' and '}'.
479 # (OC) Add or remove space inside Objective-C boxed dictionary '{' and '}'
482 # Add or remove space after open brace in an unnamed temporary
486 # Add or remove space before close brace in an unnamed temporary
490 # Add or remove space inside an unnamed temporary direct-list-initialization.
493 # Add or remove space inside '{' and '}'.
496 # Add or remove space inside '{}'.
499 # Add or remove space around trailing return operator '->'.
502 # Add or remove space between return type and function name. A minimum of 1
506 # Add or remove space between type and open brace of an unnamed temporary
510 # Add or remove space between function name and '(' on function declaration.
513 # Add or remove space between function name and '()' on function declaration
517 # Add or remove space between function name and '(' with a typedef specifier.
520 # Add or remove space between alias name and '(' of a non-pointer function type typedef.
523 # Add or remove space between function name and '()' on function definition
527 # Add or remove space inside empty function '()'.
531 # Add or remove space inside function '(' and ')'.
534 # Add or remove space inside the first parentheses in a function type, as in
538 # Add or remove space between the ')' and '(' in a function type, as in
542 # Add or remove space between ']' and '(' when part of a function call.
545 # Add or remove space between ')' and '{' of function.
548 # Add or remove space between ')' and '{' of s function call in object
554 # (Java) Add or remove space between ')' and '{{' of double brace initializer.
557 # Add or remove space between function name and '(' on function calls.
560 # Add or remove space between function name and '()' on function calls without
564 # Add or remove space between the user function name and '(' on function
570 # Add or remove space inside user function '(' and ')'.
573 # Add or remove space between nested parentheses with user functions,
577 # Add or remove space between a constructor/destructor and the open
581 # Add or remove space between a constructor without parameters or destructor
585 # Add or remove space between 'return' and '('.
588 # Add or remove space between 'return' and '{'.
591 # Add or remove space between '__attribute__' and '('.
594 # Add or remove space between 'defined' and '(' in '#if defined (FOO)'.
597 # Add or remove space between 'throw' and '(' in 'throw (something)'.
600 # Add or remove space between 'throw' and anything other than '(' as in
604 # Add or remove space between 'catch' and '(' in 'catch (something) { }'.
608 # (OC) Add or remove space between '@catch' and '('
612 # (OC) Add or remove space before Objective-C protocol list
616 # (OC) Add or remove space between class name and '('
620 # (D) Add or remove space between 'version' and '('
624 # (D) Add or remove space between 'scope' and '('
628 # Add or remove space between 'super' and '(' in 'super (something)'.
633 # Add or remove space between 'this' and '(' in 'this (something)'.
638 # Add or remove space between a macro name and its definition.
641 # Add or remove space between a macro function ')' and its definition.
644 # Add or remove space between 'else' and '{' if on the same line.
647 # Add or remove space between '}' and 'else' if on the same line.
650 # Add or remove space between '}' and the name of a typedef on the same line.
653 # Add or remove space before the '{' of a 'catch' statement, if the '{' and
657 # (OC) Add or remove space before the '{' of a '@catch' statement, if the '{'
662 # Add or remove space between '}' and 'catch' if on the same line.
665 # (OC) Add or remove space between '}' and '@catch' if on the same line.
669 # Add or remove space between 'finally' and '{' if on the same line.
672 # Add or remove space between '}' and 'finally' if on the same line.
675 # Add or remove space between 'try' and '{' if on the same line.
678 # Add or remove space between get/set and '{' if on the same line.
681 # Add or remove space between a variable and '{' for C++ uniform
685 # Add or remove space between a variable and '{' for a namespace.
690 # Add or remove space before the '::' operator.
693 # Add or remove space after the '::' operator.
696 # (D) Add or remove around the D named array initializer ':' operator.
699 # Add or remove space after the '!' (not) unary operator.
704 # Add or remove space after the '~' (invert) unary operator.
709 # Add or remove space after the '&' (address-of) unary operator. This does not
715 # Add or remove space around the '.' or '->' operators.
720 # Add or remove space after the '*' (dereference) unary operator. This does
726 # Add or remove space after '+' or '-', as in 'x = -5' or 'y = +7'.
731 # Add or remove space between '++' and '--' the word to which it is being
737 # Add or remove space before a backslash-newline at the end of a line.
742 # (OC) Add or remove space after the scope '+' or '-', as in '-(void) foo;'
746 # (OC) Add or remove space after the colon in message specs,
750 # (OC) Add or remove space before the colon in message specs,
754 # (OC) Add or remove space after the colon in immutable dictionary expression
758 # (OC) Add or remove space before the colon in immutable dictionary expression
762 # (OC) Add or remove space after the colon in message specs,
766 # (OC) Add or remove space before the colon in message specs,
770 # (OC) Add or remove space after the (type) in message specs,
774 # (OC) Add or remove space after the first (type) in message specs,
778 # (OC) Add or remove space between '@selector' and '(',
783 # (OC) Add or remove space between '@selector(x)' and the following word,
787 # (OC) Add or remove space inside '@selector' parentheses,
792 # (OC) Add or remove space before a block pointer caret,
796 # (OC) Add or remove space after a block pointer caret,
800 # (OC) Add or remove space between the receiver and selector in a message,
804 # (OC) Add or remove space after '@property'.
807 # (OC) Add or remove space between '@synchronized' and the open parenthesis,
811 # Add or remove space around the ':' in 'b ? t : f'.
814 # Add or remove space before the ':' in 'b ? t : f'.
819 # Add or remove space after the ':' in 'b ? t : f'.
824 # Add or remove space around the '?' in 'b ? t : f'.
827 # Add or remove space before the '?' in 'b ? t : f'.
832 # Add or remove space after the '?' in 'b ? t : f'.
847 # (D) Add or remove space around the D '..' operator.
850 # Add or remove space after ':' in a Java/C++11 range-based 'for',
854 # Add or remove space before ':' in a Java/C++11 range-based 'for',
858 # (D) Add or remove space between 'extern' and '(' as in 'extern (C)'.
861 # Add or remove space after the opening of a C++ comment,
873 # Add or remove space between #else or #endif and a trailing comment.
876 # Add or remove space after 'new', 'delete' and 'delete[]'.
879 # Add or remove space between 'new' and '(' in 'new()'.
882 # Add or remove space between ')' and type in 'new(foo) BAR'.
885 # Add or remove space inside parenthesis of the new operator
889 # Add or remove space after the open parenthesis of the new operator,
895 # Add or remove space before the close parenthesis of the new operator,
901 # Add or remove space before a trailing or embedded comment.
907 # (Java) Add or remove space between an annotation and the open parenthesis.
913 # Add or remove space after 'noexcept'.
916 # Add or remove space after '_'.
1383 # (OC) Add or remove newline between method declaration and '{'.
1386 # (OC) Add or remove newline between Objective-C block signature and '{'.
1389 # (OC) Add or remove blank line before '@interface' statement.
1392 # (OC) Add or remove blank line before '@implementation' statement.
1395 # (OC) Add or remove blank line before '@end' statement.
1398 # (OC) Add or remove newline between '@interface' and '{'.
1401 # (OC) Add or remove newline between '@implementation' and '{'.
1404 # Add or remove newlines at the start of the file.
1411 # Add or remove newline at the end of the file.
1418 # Add or remove newline between '=' and '{'.
1421 # (D) Add or remove newline between '=' and '['.
1424 # Add or remove newline between '[]' and '{'.
1427 # (D) Add or remove newline after '= ['. Will also affect the newline before
1431 # Add or remove newline between a function call's ')' and '{', as in
1435 # Add or remove newline between 'enum' and '{'.
1438 # Add or remove newline between 'enum' and 'class'.
1441 # Add or remove newline between 'enum class' and the identifier.
1444 # Add or remove newline between 'enum class' type and ':'.
1447 # Add or remove newline between 'enum class identifier :' and type.
1450 # Add or remove newline between 'struct and '{'.
1453 # Add or remove newline between 'union' and '{'.
1456 # Add or remove newline between 'if' and '{'.
1459 # Add or remove newline between '}' and 'else'.
1462 # Add or remove newline between 'else if' and '{'. If set to ignore,
1466 # Add or remove newline between 'else' and '{'.
1469 # Add or remove newline between 'else' and 'if'.
1472 # Add or remove newline before '{' opening brace
1475 # Add or remove newline before 'if'/'else if' closing parenthesis.
1478 # Add or remove newline between '}' and 'finally'.
1481 # Add or remove newline between 'finally' and '{'.
1484 # Add or remove newline between 'try' and '{'.
1487 # Add or remove newline between get/set and '{'.
1490 # Add or remove newline between 'for' and '{'.
1493 # Add or remove newline before the '{' of a 'catch' statement, as in
1497 # (OC) Add or remove newline before the '{' of a '@catch' statement, as in
1501 # Add or remove newline between '}' and 'catch'.
1504 # (OC) Add or remove newline between '}' and '@catch'. If set to ignore,
1508 # Add or remove newline between '}' and ']'.
1511 # Add or remove newline between '}' and ')' in a function invocation.
1514 # Add or remove newline between 'while' and '{'.
1517 # (D) Add or remove newline between 'scope (x)' and '{'.
1520 # (D) Add or remove newline between 'unittest' and '{'.
1523 # (D) Add or remove newline between 'version (x)' and '{'.
1526 # (C#) Add or remove newline between 'using' and '{'.
1529 # Add or remove newline between two open or close braces. Due to general
1533 # Add or remove newline between 'do' and '{'.
1536 # Add or remove newline between '}' and 'while' of 'do' statement.
1539 # Add or remove newline between 'switch' and '{'.
1542 # Add or remove newline between 'synchronized' and '{'.
1545 # Add a newline between ')' and '{' if the ')' is on a different line than the
1552 # Add a newline after '(' if an if/for/while/switch condition spans multiple
1556 # Add a newline before ')' if an if/for/while/switch condition spans multiple
1570 # Add or remove newline between a case ':' and '{'.
1575 # Add or remove newline between ')' and 'throw'.
1578 # Add or remove newline between 'namespace' and '{'.
1581 # Add or remove newline after 'template<...>' of a template class.
1584 # Add or remove newline after 'template<...>' of a template class declaration.
1589 # Add or remove newline after 'template<>' of a specialized class declaration.
1594 # Add or remove newline after 'template<...>' of a template class definition.
1599 # Add or remove newline after 'template<>' of a specialized class definition.
1604 # Add or remove newline after 'template<...>' of a template function.
1607 # Add or remove newline after 'template<...>' of a template function
1613 # Add or remove newline after 'template<>' of a specialized function
1619 # Add or remove newline after 'template<...>' of a template function
1625 # Add or remove newline after 'template<>' of a specialized function
1631 # Add or remove newline after 'template<...>' of a template variable.
1634 # Add or remove newline between 'template<...>' and 'using' of a templated
1638 # Add or remove newline between 'class' and '{'.
1641 # Add or remove newline before or after (depending on pos_class_comma,
1645 # Add or remove newline after each ',' in the constructor member
1650 # Add or remove newline before first element, after comma, and after last
1654 # Add or remove newline between return type and function name in a function
1659 # Add or remove newline between return type and function name inside a class
1664 # Add or remove newline between class specification and '::'
1669 # Add or remove newline between function scope and name, as in
1673 # Add or remove newline between return type and function name in a prototype.
1676 # Add or remove newline between a function name and the opening '(' in the
1683 # Add or remove newline between a function name and the opening '(' in the
1690 # Add or remove newline between a function name and the opening '(' in the
1697 # Add or remove newline after '(' in a function declaration.
1700 # Add or remove newline after '(' in a function definition.
1717 # Add or remove newline after each ',' in a function declaration.
1720 # Add or remove newline after each ',' in a function definition.
1723 # Add or remove newline after each ',' in a function call.
1734 # Add or remove newline before the ')' in a function declaration.
1737 # Add or remove newline before the ')' in a function definition.
1754 # Add or remove newline between '()' in a function declaration.
1757 # Add or remove newline between '()' in a function definition.
1760 # Add or remove newline between '()' in a function call.
1798 # Add or remove newline between function signature and '{'.
1801 # Add or remove newline between function signature and '{',
1805 # Add or remove newline between C++11 lambda signature and '{'.
1808 # Add or remove newline between 'return' and the return expression.
1814 # (Java) Add or remove newline between the ')' and '{{' of the double brace
1854 # Add or remove newline between the close brace and identifier,
1874 # Add or remove blank line before 'if'.
1877 # Add or remove blank line after 'if' statement. Add/Force work only if the
1881 # Add or remove blank line before 'for'.
1884 # Add or remove blank line after 'for' statement.
1887 # Add or remove blank line before 'while'.
1890 # Add or remove blank line after 'while' statement.
1893 # Add or remove blank line before 'switch'.
1896 # Add or remove blank line after 'switch' statement.
1899 # Add or remove blank line before 'synchronized'.
1902 # Add or remove blank line after 'synchronized' statement.
1905 # Add or remove blank line before 'do'.
1908 # Add or remove blank line after 'do/while' statement.
1932 # Add or remove newline before or after (depending on pos_class_colon) a class
1936 # Add or remove newline around a class constructor colon. The exact position
2159 # (C#) Add or remove newline between property and the '{'.
2175 # (Java) Add or remove newline after an annotation statement. Only affects
2179 # (Java) Add or remove newline between two annotations.
2705 # Add or remove braces on a single-line 'do' statement.
2708 # Add or remove braces on a single-line 'for' statement.
2711 # (Pawn) Add or remove braces on a single-line function definition.
2714 # Add or remove braces on a single-line 'if' statement. Braces will not be
2731 # Add or remove braces on single-line 'while' statement.
2734 # Add or remove braces on single-line 'using ()' statement.
2756 # Add or remove unnecessary parenthesis on 'return' statement.
2830 # Add or remove braces around a fully braced case statement. Will only remove
2838 # Add or remove the comma after the last value of an enumeration.
2872 # Add or remove indentation of preprocessor directives inside #if blocks
2888 # Add or remove space after # based on pp_level of #if blocks.
3039 #   Add    - makes sure there is 1 or more space/brace/newline/etc
3041 #            behaves like Add in some contexts

Last Index update Sun Aug 20 00:18:20 CST 2023