什么clang-format选项控制方法调用参数的格式？答案

【问题标题】：What clang-format options control format of method calling parameters?什么clang-format选项控制方法调用参数的格式？
【发布时间】：2014-04-07 15:14:23
【问题描述】：

我知道人们对如何在 Objective-C 中格式化方法调用有不同的看法，即

[self presentViewController:scanViewController
                   animated:YES
                 completion:nil];

对

[self presentViewController:scanViewController animated:YES completion:nil];

我使用 .clang 格式文件中的哪些选项来控制这种缩进？（如果我不想要它，冒号排队等）

另外，只是我还是这个格式化程序对块一无所知？注意成功块的 if 语句没有缩进，失败块中的 NSLog 函数也没有缩进。

[self.client getPath:path
    parameters:parameters
    success:^(AFHTTPRequestOperation *operation, id responseObject) {
    if ([from_id isEqualToString:self.from_id]) {
        self.image.image = [UIImage imageWithData:responseObject];
    }
    }
    failure:^(AFHTTPRequestOperation *operation, NSError *error) {
    NSLog(error.description);
    }];

【问题讨论】：

我决定改用 uncrustify。
无法禁用冒号对齐是 clang 格式中唯一困扰我的事情。或者，更好的是，在带有块参数的方法中禁用冒号对齐。
@user3099609，如果您仍需要此问题的解决方案，请查看下面的答案。

标签： objective-c formatting clang clang-format

【解决方案1】：

我查看了clang-format源代码，其中完成了objective-c方法表达式的格式化，并在这里找到了它：http://llvm.org/svn/llvm-project/cfe/trunk/lib/Format/ContinuationIndenter.cpp

代码：

// If this '[' opens an ObjC call, determine whether all parameters fit
// into one line and put one per line if they don't.
if (Current.Type == TT_ObjCMethodExpr &&
    getLengthToMatchingParen(Current) + State.Column >
        getColumnLimit(State))
  BreakBeforeParameter = true;

如您所见，行为仅由配置选项 ColumnLimit 控制。您可以将其设置为 0 以抑制换行符。不幸的是，这当然会影响完整的格式。

关于块内缺少缩进的问题：我无法使用最新的 Visual Studio 插件 (SVN r203967) 重现该问题。你有没有弄过 ContinuationIndentWidth ？

【讨论】：

我已经将我的 ColumnLimit 设置为 0，并且我正在使用带有插件的 Xcode 使用 .clang-format 文件在保存时进行格式化。
哦，将 ColumnLimit 设置为 0 不起作用。您必须将 ColumnLimit 设置为非常大的值，例如 1000 以避免方法表达式中的换行符。关于您的第二个问题，您的 .clang-format 的内容是什么，您使用的是哪个版本的 clang-format？
最近使用 clang-format 3.7 改变了吗？将 ColumnLimit 设置为 0 停止为我工作，我很生气，因为它工作得很好！ :D 将 ColumnLimit 设置为 1000 也不起作用！有没有其他办法？
我已经更新了brew 提供的clang-format 版本，所以它现在应该再次尊重ColumnLimit 0。 github.com/Homebrew/homebrew-core/pull/9774

【解决方案2】：

我的变量 ColumnLimit 为零。方法调用的格式如下：

[self presentViewController:scanViewController animated:YES completion:nil];

我想在不更改 ColumnLimit 变量的情况下将它们格式化如下：

[self presentViewController:scanViewController
               animated:YES
             completion:nil];

似乎没有clang配置选项可以实现这一点。但是，我找到了一个适合我的解决方案：

如果我在第一个参数（此处为 scanViewController）之后添加 // 和换行符，则使用 clang 格式化代码会产生所需的结果：

[self presentViewController:scanViewController //
                   animated:YES
                 completion:nil];

这意味着 clang 格式将所有参数放在单独的行中并对齐冒号。

【讨论】：

我真的很想看到一个选项可以打开/关闭，而不会弄乱 ColumnLimit。
我对这两种方式都没有具体意见，但列对齐的方式会使调用中的任何块缩进非常深（如冒号+缩进宽度）。我真的希望情况并非如此。
@StevenHepting，我真的很想有一个选项来禁用此行为

【解决方案3】：

我遇到了同样的问题：我想在带有块参数的方法中禁用冒号对齐。

最后我通过在Clang-Format源代码中改变它的行为来解决它：
我在ContinuationIndenter.cpp 的任何地方都将BreakBeforeParamater = true 更改为BreakBeforeParameter = false（感谢@Matthias 提供代码参考）。

这个解决方案并不漂亮，但很有效。现在 Clang-Format 不会将 ObjC 参数拆分为新行。

您可以从Dropbox下载修改后的工具。

附言。原始代码是从这个 repo 克隆的：http://llvm.org/git/clang.git

【讨论】：

我现在更新了 clang-format 的版本，您使用 brew 获得的版本可能会再次起作用。告诉我。