<table border="1" cellspacing="0" cellpadding="8">
    <tr>
        <th>Issue</th>
        <td>
            <a href=https://github.com/llvm/llvm-project/issues/94283>94283</a>
        </td>
    </tr>

    <tr>
        <th>Summary</th>
        <td>
            [clang-format] Proposal for brace wrapping before the first statement
        </td>
    </tr>

    <tr>
      <th>Labels</th>
      <td>
            clang-format
      </td>
    </tr>

    <tr>
      <th>Assignees</th>
      <td>
      </td>
    </tr>

    <tr>
      <th>Reporter</th>
      <td>
          LMauricius
      </td>
    </tr>
</table>

<pre>
    After pondering on the brace style that most suits me, I found the following rarely mentioned style:
```c++
if (condition)
{   printf("The condition is true");
    return true;
} else
{   printf("The condition is false");
    return false;
}
```

This style might look very unusual to most people, but it isn't unseen. Nowadays it is often called the Horstmann style, based on its author's name. There are a few books written with it,  and it is mentioned on Wikipedia - [Horstmann Indentation_style](https://en.wikipedia.org/wiki/Indentation_style#Horstmann)

However, there isn't much tool support for it.

While the author himself has abandoned it, that was only because the author had to fight the formatting engines without support for it. I believe the reason why it's not more popular is because it is much harder to type, especially in editors where we usually get automatic indenting, and because the two most common styles are mentioned in many arguments on the 'best' style. On the other hand, I believe it is much easier to READ, and it offers the best of both worlds:
- It doesn't add a new line
- It makes the braces line up

With a formatting engine's automatic code modification, we could alleviate the difficulty in writing and retain the improvement in reading. This is obviously subjective, but many people including me would use this style as their favorite, along with at least one book author, as mentioned [here](https://horstmann.com/unblog/2010-06-28/braces.html)

# Needed changes
A boolean setting could be added in `BraceWrapping` called `BeforeOpeningStatement` with `true` as ts default. The comparison in code:
```c++
// true
if (condition)
{
    printf("The condition is true");
    return true;
} else
{
    printf("The condition is false");
    return false;
}
// false
if (condition)
{   printf("The condition is true");
    return true;
} else
{   printf("The condition is false");
    return false;
}
```

The way this could work is that for any braced block which gets wrapped, except for single line ones, the first statement will be put on the same line with the number of padding spaces equal to its usual indent size minus 1.
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJzkVl1v28oR_TXUy8ACvfp-0IMdV4iBNinaAHkshuSQnHq5y-6HWPXXF7NLWXaSiwQXuE8XkGWIuzPcOefMmUXvuTNEx2LzWGyeFhhDb93xr3_D6Ljm6BeVbS7HhzaQg9GahhybDqyB0BNUDmsCHy6aIPQYYLA-gI8cPAxUqA_wDK2Npkm7W6u1nSTcoSN9gYFMYGuoySmK1UNRPhXlQ7Et86cu1KN80lNuoVD72pqGJapQh3n37hEARscmtIXaF0p96Qle9wF7CC5SoZSErOZsAACOQnQmr16fF7snIO3pl3O3KLt_M3lefpP9mxLnn-n7S89-RnPgrg-grX2BM7kLRBN9RA3BZoxHsqNOCFcxAAdgbwq1CxCNJzJL-GQnbPDi8xrYNpCBGrWmTMZH63wY0JgZe8mEnhqhVujLQijUzoPBgZbwpSdHgPIHLU1QWfviYXIcJPPEoQcOkgbQNPNbbwRbA1_5hUdqGOEOis3j7QDPpiETUHb-Kx9m81SofR_C6EUT6lSoE5nldE2wtK4r1El-F-r0fbhavSa_qSR9f7QTncnJMUOq5wrbEOsegrUafBxH6wK01gGH5dvorz0nodOMDvQ8eNIt9OgBKzRNqjXDkPphQg_W6AtUVGP074OxETrbxHTuDzdgCNIgZDo25BOsNoZvDwXPUJFmOueEjtBbA1N_Se8Wyqz0oiMY7Rg1OiHjeoSZGim4R9eQk1OEy5g0QH6kmlHrC7ABajhY52FKWE0ESYT6Ah0FKcMOGLgGTgyw6SSDsP-22jDNkq3tMNhZbj4J6SYPNjCguQC6LspTf3WYQu0q8lJUDlzC57xghT_o0TTZZq54vKmO0HOu7h9_eXi6no0D2LYl57ODkZffUNnQw2SdbvyrDd3Bc4DG0iwRbBpAMDSBZkNvtgz4Qv7mhz6tQxzfSUf6A7-nOLF1Q7K2DcFgG265xuxyHwT32kbdgHTvmTFkYBtuW66jDokqaURJKyU6CsgZJh5GZ88kmMouR9iw6aSb2SdfqM5so9cX8LH6N9WBz6-ukhjJRgNsah0lFAaCKZ0mE_zqWJggYActnq3jkNKgtqbL5oABNKGgbSiZx6vFfJDYmxaKzaPI7Ucm0F_belnboVCnaCptxQpUeV_elds7sehTZmHZh0F_0_6FWsEnooYaqHs0Hfn8_EEOpAkNeMrsZMArEtazPott-SiJvzocR9H6trz6qSxRax19Hsmw6f4ZMCTIZU8qvtiWacpsy4STh4ZajDokW5XOGNGx9DCbpIGfjMKMRh5cP5uNt4n0h43IX3zF75yUuda8-qe5CBBMeMntlaU4WfeSKpCxImNAmjMpvYFK2_oFpp7rXpxZpjKOIyVnpP_WNOYIz6bTlN3JGvLzFISWndzarqKFibUW6Y8xXG3Y4zAHJjnLIxOHipx454hNcgY_Jvej_8wXFblG5FtLHhDg-X9yszHRw_1y0RxXzWF1wAUd73f3u_WmPGzXi_7YbuodVYf9utrsqhY3q-qw2qxxX2HbqmqjFnxUpVqX23Kl7tdqvV625b7E7UGVarVd7w9UrEsakPVS6_Mgl4UFex_peFir_WqhsSLt04VXqVqj6e6yLQt3m6eFO0rYXRU7X6xLzT74W6LAQafL8rvAzRP83dnRetQJ6XwvnmangCqZw4-wXkSnj-89ruPQx2o2OHnv_O9udFYMulCnVI0v1CkXdD6q_wcAAP__zQ_dKw">