スタイルガイド

文法はそのうちに、特に多くのセマンティックアクションが様々な点に接続されるようになると、理解するのが非常に困難なものになりがちである。

このコーディングスタイルは、 ANTLR/PCCTS スタイル（ Terrence Parr ）および Boost コーディングガイドライン （ David Abrahams と Nathan Myers ）に手を加え、拡張したものである。 これは Joel de Guzman 、 Chris Uzdavinis および Hartmu Kaiser の合作である。

• ルール名は標準 C++ （および Boost）の慣例を用いる。 ルール名は非常に長くなることがある。
• '=' はきっちり空白４つ分インデントする。 Boost と同様、タブではなく空白を用いる。
• オペランドを別々の行に分割する場合、セマンティックアクションはきちんと右に置く。
• 最後の行のセミコロンはそのルールの終端を表す。
• シーケンスの近接する各部は、一つのレベルに属すものなら、全て一つの字下げレベルとなるように字下げすべきである。

    program
        =   program_heading [heading_action]
            >> block [block_action]
            >> '.'
        |   another_sequence
            >> etc
        ;

• 識別子よりその文法の中のリテラルを選ぶこと。 例えば、 PROGRAM の代わりに "program" を、 GTE の代わりに '>=' を、そして DOT の代わりに '.' を用いる。 これが可能でない場合（使用されたトークンが整数で識別されなければならない時など）には、大文字の識別子を代わりに用いる。
• 短い式ではオペランドを分ける必要はない。 例えば *(',' >> file_identifier) は行が８０文字を越えない限り、分割しない。
• あるシーケンスが一行に収まるならば、 それらをそのルールから明確に区切るために括弧の内側にスペースを置く。

    program_heading
        =   as_lower_d["program"]
            >> identifier
            >> '('
            >> file_identifier
            >> *( ',' >> file_identifier )
            >> ')'
            >> ';'
        ;

• ディレクティブのネスト：ルールが一行（８０文字）に収まらないなら、 一段字下げして次の行に続ける。
• ディレクティブ、（ Phoenix か LL ラムダ式 を用いた）セマンティック式、またはパーサの括弧は 以下のように配置されるべきである。

    identifier
        =   nocase
            [
                lexeme
                [
                    alpha >> *(alnum | '_') [id_action]
                ]
            ]
        ;

• 単項演算子（例えば Kleene star ）のネスト
• 引数一つのルール演算子（ Kleene star 、 '!' 、 '+' など）は、 もしこのルールがその後に本体かシーケンスを伴っており、それが一行に収まらないなら、 対応する字下げレベルの前にスペース一つを置く。 これはより整合の取れた書式化をもたらし、 またルールの「本体」をルールそれ自身と同じインデントレベルに移し、 その単項演算子を強調する。

    block
        =  *(   label_declaration_part
            |   constant_definition_part
            |   type_definition_part
            |   variable_declaration_part
            |   procedure_and_function_declaration_part
            )
            >> statement_part
        ;

Copyright © 2001-2003 Joel de Guzman
Copyright © 2001-2002 Hartmut Kaiser
Copyright © 2001-2002 Chris Uzdavinis

Permission to copy, use, modify, sell and distribute this document is granted provided this copyright notice appears in all copies. This document is provided "as is" without express or implied warranty, and with no claim as to its suitability for any purpose.

Japanese Translation Copyright © 2003-2004 Kent.N

オリジナルの、及びこの著作権表示が全ての複製の中に現れる限り、この文書の複製、利用、変更、販売そして配布を認める。このドキュメントは「あるがまま」に提供されており、いかなる明示的、暗黙的保証も行わない。また、いかなる目的に対しても、その利用が適していることを関知しない。

このドキュメントの対象: Boost Version 1.30.0
最新版ドキュメント（英語）