Clang 格式换行符

我正在寻找一个clang-format设置以防止工具删除换行符。

例如，我有我的ColumnLimit设置为 120，这是我重新格式化一些示例代码时发生的情况。

Before:

#include <vector>
#include <string>

std::vector<std::string> get_vec()
{
   return std::vector<std::string> {
      "this is a test",
      "some of the lines are longer",
      "than other, but I would like",
      "to keep them on separate lines"
   };
}

int main()
{
   auto vec = get_vec();
}

After:

#include <vector>
#include <string>

std::vector<std::string> get_vec()
{
   return std::vector<std::string>{"this is a test", "some of the lines are longer", "than other, but I would like",
         "to keep them on separate lines"};
}

int main()
{
   auto vec = get_vec();
}

我想要的是，该工具会中断超过 120 个字符的行，但不会仅仅因为它们少于 120 个字符就决定合并行。

有这样的选择吗？文档中没有任何内容对我来说很突出。

因此，在弄乱了 clang 格式代码并制作了一些补丁之后，这是我的两分钱：

• Clang 格式基于，

  • 使用以下方法解析 ASTlibclang，这基本上消除了所有空白
  • 将令牌序列分解为“展开的行”，就像“逻辑”代码行
  • 应用规则/配置信息有时将“展开的行”分割成更小的单元
  • 使用新的空格/缩进再次将其全部吐出来

  让它尊重原始的whitepsace并不容易，当你第一次解析代码时，这种情况会被抛弃。

• 您可以通过以下方式最轻松地控制换行符的位置

  • 设置列限制
  • 使用“bin pack 参数”选项
  • 为各种中断设置惩罚——在函数返回类型之后中断、在第一次调用参数之前中断、中断字符串文字、中断注释...
  • 将注释放在行尾（clang 格式无法删除注释，因此必须拆分行）
  • 使用 clang-format off / on 指令

您可以尝试以下一件事：

std::vector<std::string> get_vec()
{
   return std::vector<std::string> {   //
      "this is a test",                //
      "some of the lines are longer",  //
      "than other, but I would like",  //
      "to keep them on separate lines" //
   };
}

这样做的优点是// clang-format off就是，如果您稍后更改制表符宽度或其他选项，这些代码行仍然会获得这些格式更改，因此您无需手动进入// clang-format off地区来修复它。然而，它仍然有点黑客，YMMV。

最终，clang-format很大程度上是在整个代码库上采用统一的格式，确保程序中所有字符串文字的格式都相同。如果您想对换行决策进行微观控制，这并不符合该工具的精神，您必须执行诸如禁用它之类的操作。

这有时会令人沮丧，尤其是。当你想用数组做事情并对齐列或其他东西时——例如，下面是来自 lua C api 的一些自然代码：

static luaL_Reg const methods[] = {
    {"matches",               &dispatch::intf_match_unit},
    {"to_recall",             &dispatch::intf_put_recall_unit},
    {"to_map",                &dispatch::intf_put_unit},
    {"erase",                 &dispatch::intf_erase_unit},
    {"clone",                 intf_copy_unit},
    {"extract",               &dispatch::intf_extract_unit},
    {"advance",               intf_advance_unit},
};

当 clang-format 运行时，它通常不会对齐右列，而是在逗号后面放置固定数量的空格，据我所知，您对此无能为力。

或者，如果您有 4 x 4 矩阵供 OpenGL 使用：

      constexpr float shadow_skew_hardcoded[16] =
        { 1.0f, 0.0f, 0.0f, 0.0f,
          0.5f, 0.5f, 0.0f, 0.0f,
          0.0f, 0.0f, 1.0f, 0.0f,
          0.0f, 0.0f, 0.0f, 1.0f };

如果你让 clang-format 运行这样的东西，它只会破坏它们，而且据我所知，没有简单的方法可以让它很好地格式化它们，所以你只需要诉诸“大量琐碎的评论”黑客，或者使用当你有这样的东西时，请关闭 clang-format 。这些只是该工具的固有局限性。如果您不喜欢做这样的事情，那么它可能不适合您。