今回は
前回書いたアラインメントオプションとかインデントオプションとかが、非常にボリュームがあって、Qiitaで一つの記事をビューしようとしたら、途中で切れてたw。仕方がないので、前編と後編にそれぞれの記事を分割しました。まだ、空白オプションと改行オプションという地獄のようなオプションリストが残ってますが、まだバリエーションが少ないオプションの解説をしてきます。
今回、解説するのは、ポジショニングオプション。いくつかのトークン (プログラミング言語の構成要素) が行の先頭もしくは末尾に現れた時、行頭に置くべきか、それとも行末に置くべきか、悩んだりしますよね (しないかもしれませんが)。そんな時、ポジションがルール化されてたら嬉しいですよね。それを一つ一つ決めるのが、これらのオプションたちです。本当に、細かいところなので、別に設定する必要もないような気もします。プログラマの好みなど許さない！私のコーディング規約に従いなさいという人は、ここまで設定しちゃいましょう。
各ポジションオプションは、次の8種類の設定を選んでいきます。
- ignore
この設定項目を無視します。すべてのポジションオプションのデフォルト値です。 - join
行頭もしくは行末に、そのトークンがあった場合、行と行をつなげます。 - lead
行末に、そのトークンがあった場合、そのトークンを次の行の行頭に挿入します。 - lead_break
行末に、そのトークンがあった場合、そのトークンを次の行の行頭に挿入します。
また、そのトークンが、行中にある場合、そのトークンの直前で改行します。 - lead_force
行末に、そのトークンがあった場合、そのトークンを次の行の行頭に挿入します。
また、そのトークンが、行中にある場合、そのトークンの直前で改行します。
ただし、そのトークンしか行に存在しない場合、次の行の行頭に移動させます。 - trail
行頭に、そのトークンがあった場合、そのトークンを前の行の行末に挿入します。 - trail_break
行頭に、そのトークンがあった場合、そのトークンを前の行の行末に挿入します。
また、そのトークンが、行中にある場合、そのトークンの直後で改行します。 - trail_force
行頭に、そのトークンがあった場合、そのトークンを前の行の行末に挿入します。
また、そのトークンが、行中にある場合、そのトークンの直後で改行します。
ただし、そのトークンしか行に存在しない場合、前の行の行末に移動させます。
leadとtrailの関係はこんな感じです。
lead_trail.cpp
// こちらがleadである。'+'が行頭に置かれる。
int foo = bar
+ bar;
// こちらがtrailである。
int foo = bar +
bar;
breakとforceの違いはこんな感じです。'+'が行末に置かれる。
break_force.cpp
// 整形前
int foo = bar + bar +
bar
+
bar;
// こちらがbreakである。トークンごとに改行する。
int foo = bar +
bar +
bar
+
bar;
// こちらがforceである。トークン単独にならないようにする。
int foo = bar +
bar +
bar +
bar;
それから、ポジション整形によって行頭や行末に移動されることとなったトークンのインデントやアラインメント、そして空白などは別のオプションによって決まります。特に、空白がない不格好なコードが生成されたりします。
そうやって結局設定していかなければ、気の利いたコード整形は実現されないということですかね。
ポジションオプション一覧
ちなみに、私の環境では、pos_class_commaの設定がどうしても整形に反映されませんでした。
| 項目 | 説明 |
|---|---|
| pos_arith | 式が折り返す時の算術演算子の位置 { ignore, join, lead, lead_break, lead_force, trail, trail_break, trail_force } |
| pos_assign | 式が折り返す時の代入演算子の位置 '{'が続く'='には影響しない { ignore, join, lead, lead_break, lead_force, trail, trail_break, trail_force } |
| pos_bool | 式が折り返す時のブール演算子の位置 { ignore, join, lead, lead_break, lead_force, trail, trail_break, trail_force } |
| pos_compare | 式が折り返す時の比較演算子の位置 { ignore, join, lead, lead_break, lead_force, trail, trail_break, trail_force } |
| pos_conditional | 式が折り返す時の三項演算子 (b ? t : f) の位置 { ignore, join, lead, lead_break, lead_force, trail, trail_break, trail_force } |
| pos_comma | 式が折り返す時の','の位置 { ignore, join, lead, lead_break, lead_force, trail, trail_break, trail_force } |
| pos_class_comma | コンストラクタのメンバ初期化リストにおける','の位置 { ignore, join, lead, lead_break, lead_force, trail, trail_break, trail_force } |
| pos_class_colon | コンストラクタとメンバ初期化の間の':'の位置 { ignore, join, lead, lead_break, lead_force, trail, trail_break, trail_force } |
僕の設定
position.cfg
pos_arith = trail
pos_assign = trail
pos_bool = trail
pos_compare = trail
pos_conditional = trail
pos_comma = trail
pos_class_comma = trail
pos_class_colon = lead
POS_ARITH
pos_arith.cpp
// pos_arith = lead
// '+'演算子は行頭に置かれる。
int foobar = foo + foo + foo
+ bar + bar + bar;
POS_ASSIGN
pos_assign.cpp
// pos_assign = lead
// '='演算子は行頭に置かれる。
int foobar
= foo + bar;
POS_BOOL
pos_bool.cpp
// pos_bool = lead
// '&&'演算子は行頭に置かれる。
if (foo && foo && bar
&& bar)
POS_COMPARE
pos_compare.cpp
// pos_compare = lead
// '>'演算子は行頭に置かれる。
if (foo + bar + foo
> bar + bar + bar)
POS_CONDITIONAL
pos_conditional.cpp
// pos_conditional = lead_break;
// '?' / ':'演算子は行頭に置かれる。
bool foo = (bar == boo)
? bee
: bow;
POS_COMMA
pos_comma.cpp
// pos_comma = trail
// ','は行末に置かれる。
int foo1, foo2, foo3,
bar1, bar2, bar3;
POS_CLASS_COMMA
pos_class_comma.cpp
// pos_class_comma = lead
// クラスコンストラクタのメンバ初期化リストの','は行頭に置かれる。
class Foo
{
Foo(int foo, int bar)
: m_foo(foo)
, m_foo(bar);
};
POS_CLASS_COLON
pos_class_colon.cpp
// pos_class_colon = lead
// クラスコンストラクタのメンバ初期化リストの':'は行頭に置かれる。
class Foo
{
Foo(int foo, int bar)
: m_foo(foo)
, m_foo(bar);
};