[boost-doc-zh] r352 committed - 升级至1.41.0，第四批，libs/目录下s-t子目录

From: boost-doc-zh@xxxxxxxxxxxxxx
To: boost-doc-zh-notify@xxxxxxxxxxxxx
Date: Fri, 04 Dec 2009 07:12:08 +0000

Revision: 352
Author: alai04
Date: Thu Dec  3 23:11:44 2009
Log: 升级至1.41.0，第四批，libs/目录下s-t子目录
http://code.google.com/p/boost-doc-zh/source/detail?r=352

Added:
 /trunk/libs/spirit/doc/html/images/alternative.png
 /trunk/libs/spirit/doc/html/images/and_predicate.png
 /trunk/libs/spirit/doc/html/images/callouts/Thumbs.db
 /trunk/libs/spirit/doc/html/images/double_performance.png
 /trunk/libs/spirit/doc/html/images/format_performance.png
 /trunk/libs/spirit/doc/html/images/int_performance.png
 /trunk/libs/spirit/doc/html/images/kleene.png
 /trunk/libs/spirit/doc/html/images/lexerflow.png
 /trunk/libs/spirit/doc/html/images/non-terminal.png
 /trunk/libs/spirit/doc/html/images/not_predicate.png
 /trunk/libs/spirit/doc/html/images/optional.png
 /trunk/libs/spirit/doc/html/images/pascal_string.png
 /trunk/libs/spirit/doc/html/images/plus.png
 /trunk/libs/spirit/doc/html/images/predicate.png
 /trunk/libs/spirit/doc/html/images/sequence.png
 /trunk/libs/spirit/doc/html/images/start_stop.png
 /trunk/libs/spirit/doc/html/images/terminal.png
 /trunk/libs/spirit/doc/html/spirit/abstracts
 /trunk/libs/spirit/doc/html/spirit/abstracts/attributes

/trunk/libs/spirit/doc/html/spirit/abstracts/attributes/compound_attributes.html/trunk/libs/spirit/doc/html/spirit/abstracts/attributes/more_compound_attributes.html/trunk/libs/spirit/doc/html/spirit/abstracts/attributes/nonterminal_attributes.html/trunk/libs/spirit/doc/html/spirit/abstracts/attributes/primitive_attributes.html

 /trunk/libs/spirit/doc/html/spirit/abstracts/attributes.html

/trunk/libs/spirit/doc/html/spirit/abstracts/parsing_expression_grammar.html

 /trunk/libs/spirit/doc/html/spirit/abstracts/syntax_diagram.html
 /trunk/libs/spirit/doc/html/spirit/abstracts.html
 /trunk/libs/spirit/doc/html/spirit/advanced
 /trunk/libs/spirit/doc/html/spirit/advanced/customize
 /trunk/libs/spirit/doc/html/spirit/advanced/customize/assign_to

/trunk/libs/spirit/doc/html/spirit/advanced/customize/assign_to/assign_to_attribute_from_iterators.html/trunk/libs/spirit/doc/html/spirit/advanced/customize/assign_to/assign_to_attribute_from_value.html

 /trunk/libs/spirit/doc/html/spirit/advanced/customize/assign_to.html
 /trunk/libs/spirit/doc/html/spirit/advanced/customize/clear_value.html
 /trunk/libs/spirit/doc/html/spirit/advanced/customize/extract_from.html
 /trunk/libs/spirit/doc/html/spirit/advanced/customize/is_container.html
 /trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate

/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/begin_container.html/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/compare_iterators.html/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/container_iterator.html/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/deref_iterator.html/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/end_container.html/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/next_iterator.html

 /trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate.html
 /trunk/libs/spirit/doc/html/spirit/advanced/customize/store_value

/trunk/libs/spirit/doc/html/spirit/advanced/customize/store_value/container_value.html/trunk/libs/spirit/doc/html/spirit/advanced/customize/store_value/push_back.html

 /trunk/libs/spirit/doc/html/spirit/advanced/customize/store_value.html
 /trunk/libs/spirit/doc/html/spirit/advanced/customize/transform.html
 /trunk/libs/spirit/doc/html/spirit/advanced/customize.html
 /trunk/libs/spirit/doc/html/spirit/advanced/indepth
 /trunk/libs/spirit/doc/html/spirit/advanced/indepth/parsers_indepth.html
 /trunk/libs/spirit/doc/html/spirit/advanced/indepth.html
 /trunk/libs/spirit/doc/html/spirit/advanced.html
 /trunk/libs/spirit/doc/html/spirit/karma
 /trunk/libs/spirit/doc/html/spirit/karma/performance_measurements

/trunk/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/trunk/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/double_performance.html/trunk/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/format_performance.html/trunk/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/int_performance.html/trunk/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance.html

 /trunk/libs/spirit/doc/html/spirit/karma/performance_measurements.html
 /trunk/libs/spirit/doc/html/spirit/karma/quick_reference

/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/common_notation.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/compound_attribute_rules.html

 /trunk/libs/spirit/doc/html/spirit/karma/quick_reference/non_terminals.html
 /trunk/libs/spirit/doc/html/spirit/karma/quick_reference/phoenix.html

/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/action.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/auxiliary.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/binary.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/boolean.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/char.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/directives.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/operators.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/real_number.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/signed_int.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/stream.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/string.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/unsigned_int.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators.html/trunk/libs/spirit/doc/html/spirit/karma/quick_reference/semantic_actions.html

 /trunk/libs/spirit/doc/html/spirit/karma/quick_reference.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference
 /trunk/libs/spirit/doc/html/spirit/karma/reference/action.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/auxiliary
 /trunk/libs/spirit/doc/html/spirit/karma/reference/auxiliary/attr_cast.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/auxiliary/eol.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/auxiliary/eps.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/auxiliary/lazy.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/auxiliary.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/binary
 /trunk/libs/spirit/doc/html/spirit/karma/reference/binary/binary_big.html

/trunk/libs/spirit/doc/html/spirit/karma/reference/binary/binary_little.html/trunk/libs/spirit/doc/html/spirit/karma/reference/binary/binary_native.html

 /trunk/libs/spirit/doc/html/spirit/karma/reference/binary.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/char
 /trunk/libs/spirit/doc/html/spirit/karma/reference/char/char_class.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/char/char_generator.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/char.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/directive
 /trunk/libs/spirit/doc/html/spirit/karma/reference/directive/alignment.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/directive/buffer.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/directive/delimit.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/directive/maxwidth.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/directive/omit.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/directive/repeat.html

/trunk/libs/spirit/doc/html/spirit/karma/reference/directive/upperlower.html

 /trunk/libs/spirit/doc/html/spirit/karma/reference/directive.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/generate_api

/trunk/libs/spirit/doc/html/spirit/karma/reference/generate_api/iterator_api.html/trunk/libs/spirit/doc/html/spirit/karma/reference/generate_api/stream_api.html

 /trunk/libs/spirit/doc/html/spirit/karma/reference/generate_api.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/generator_concepts

/trunk/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/binarygenerator.html/trunk/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/generator.html/trunk/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/narygenerator.html/trunk/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/nonterminal.html/trunk/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/primitivegenerator.html/trunk/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/unarygenerator.html

 /trunk/libs/spirit/doc/html/spirit/karma/reference/generator_concepts.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/karma_basics.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/nonterminal
 /trunk/libs/spirit/doc/html/spirit/karma/reference/nonterminal/grammar.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/nonterminal/rule.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/nonterminal.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/numeric
 /trunk/libs/spirit/doc/html/spirit/karma/reference/numeric/boolean.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/numeric/real_number.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/numeric/signed_int.html

/trunk/libs/spirit/doc/html/spirit/karma/reference/numeric/unsigned_int.html

 /trunk/libs/spirit/doc/html/spirit/karma/reference/numeric.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/operator

/trunk/libs/spirit/doc/html/spirit/karma/reference/operator/alternative.html/trunk/libs/spirit/doc/html/spirit/karma/reference/operator/and_predicate.html

 /trunk/libs/spirit/doc/html/spirit/karma/reference/operator/kleene.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/operator/list.html

/trunk/libs/spirit/doc/html/spirit/karma/reference/operator/not_predicate.html

 /trunk/libs/spirit/doc/html/spirit/karma/reference/operator/optional.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/operator/plus.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/operator/sequence.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/operator.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/stream
 /trunk/libs/spirit/doc/html/spirit/karma/reference/stream/stream.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/stream.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/string
 /trunk/libs/spirit/doc/html/spirit/karma/reference/string/string.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference/string.html
 /trunk/libs/spirit/doc/html/spirit/karma/reference.html
 /trunk/libs/spirit/doc/html/spirit/karma/tutorials
 /trunk/libs/spirit/doc/html/spirit/karma/tutorials/karma_complex.html

/trunk/libs/spirit/doc/html/spirit/karma/tutorials/karma_easier_complex.html

 /trunk/libs/spirit/doc/html/spirit/karma/tutorials/num_list.html
 /trunk/libs/spirit/doc/html/spirit/karma/tutorials/num_matrix.html
 /trunk/libs/spirit/doc/html/spirit/karma/tutorials/quick_start.html
 /trunk/libs/spirit/doc/html/spirit/karma/tutorials/semantic_actions.html
 /trunk/libs/spirit/doc/html/spirit/karma/tutorials/warming_up.html
 /trunk/libs/spirit/doc/html/spirit/karma/tutorials.html
 /trunk/libs/spirit/doc/html/spirit/karma.html
 /trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives

/trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_token_values.html

 /trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives.html
 /trunk/libs/spirit/doc/html/spirit/lex/lexer_introduction.html
 /trunk/libs/spirit/doc/html/spirit/lex/quick_reference
 /trunk/libs/spirit/doc/html/spirit/lex/quick_reference/common_notation.html
 /trunk/libs/spirit/doc/html/spirit/lex/quick_reference/lexer.html
 /trunk/libs/spirit/doc/html/spirit/lex/quick_reference/lexers.html
 /trunk/libs/spirit/doc/html/spirit/lex/quick_reference/phoenix.html

/trunk/libs/spirit/doc/html/spirit/lex/quick_reference/semantic_actions.html

 /trunk/libs/spirit/doc/html/spirit/lex/reference/lex_basics.html
 /trunk/libs/spirit/doc/html/spirit/lex/reference/lexer_api.html
 /trunk/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts
 /trunk/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/lexer.html

/trunk/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/narylexer.html/trunk/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/primitivelexer.html/trunk/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/unarylexer.html

 /trunk/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts.html
 /trunk/libs/spirit/doc/html/spirit/lex/reference/primitives

/trunk/libs/spirit/doc/html/spirit/lex/reference/primitives/char_tokendef.html

 /trunk/libs/spirit/doc/html/spirit/lex/reference/primitives.html
 /trunk/libs/spirit/doc/html/spirit/lex/tutorials/lexer_tutorials.html
 /trunk/libs/spirit/doc/html/spirit/preface.html
 /trunk/libs/spirit/doc/html/spirit/qi
 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference
 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference/common_notation.html

/trunk/libs/spirit/doc/html/spirit/qi/quick_reference/compound_attribute_rules.html

 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference/non_terminals.html
 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference/phoenix.html
 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers

/trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/action.html/trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/auxiliary.html/trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/binary.html

 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/char.html

/trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/directive.html/trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/numeric.html/trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/operator.html/trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/string.html

 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers.html
 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference/semantic_actions.html
 /trunk/libs/spirit/doc/html/spirit/qi/quick_reference.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference
 /trunk/libs/spirit/doc/html/spirit/qi/reference/action.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/auxiliary
 /trunk/libs/spirit/doc/html/spirit/qi/reference/auxiliary/attr.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/auxiliary/attr_cast.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eoi.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eol.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eps.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/auxiliary/lazy.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/auxiliary.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/basics.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/binary
 /trunk/libs/spirit/doc/html/spirit/qi/reference/binary/binary_big.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/binary/binary_little.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/binary/binary_native.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/binary.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/char
 /trunk/libs/spirit/doc/html/spirit/qi/reference/char/char.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/char/char_class.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/char.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/concepts
 /trunk/libs/spirit/doc/html/spirit/qi/reference/directive
 /trunk/libs/spirit/doc/html/spirit/qi/reference/directive/lexeme.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/directive/no_case.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/directive/omit.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/directive/raw.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/directive/repeat.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/directive/skip.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/directive.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/nonterminal
 /trunk/libs/spirit/doc/html/spirit/qi/reference/nonterminal/grammar.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/nonterminal/rule.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/nonterminal.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/numeric
 /trunk/libs/spirit/doc/html/spirit/qi/reference/numeric/boolean.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/numeric/int.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/numeric/real.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/numeric/uint.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/numeric.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/alternative.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/and_predicate.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/difference.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/expect.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/kleene.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/list.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/not_predicate.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/optional.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/permutation.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/plus.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/sequence.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator/sequential_or.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/operator.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/parse_api
 /trunk/libs/spirit/doc/html/spirit/qi/reference/parse_api/iterator_api.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/parse_api/stream_api.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/parse_api.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/parser_concepts

/trunk/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/binaryparser.html/trunk/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/naryparser.html/trunk/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/nonterminal.html

 /trunk/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/parser.html

/trunk/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/primitiveparser.html/trunk/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/unaryparser.html

 /trunk/libs/spirit/doc/html/spirit/qi/reference/parser_concepts.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/stream
 /trunk/libs/spirit/doc/html/spirit/qi/reference/stream/stream.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/stream.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/string
 /trunk/libs/spirit/doc/html/spirit/qi/reference/string/string.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/string/symbols.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference/string.html
 /trunk/libs/spirit/doc/html/spirit/qi/reference.html
 /trunk/libs/spirit/doc/html/spirit/qi/string
 /trunk/libs/spirit/doc/html/spirit/qi/tutorials

/trunk/libs/spirit/doc/html/spirit/qi/tutorials/complex___our_first_complex_parser.html/trunk/libs/spirit/doc/html/spirit/qi/tutorials/employee___parsing_into_structs.html

 /trunk/libs/spirit/doc/html/spirit/qi/tutorials/mini_xml___asts_.html

/trunk/libs/spirit/doc/html/spirit/qi/tutorials/mini_xml___error_handling.html/trunk/libs/spirit/doc/html/spirit/qi/tutorials/number_list___stuffing_numbers_into_a_std__vector.html/trunk/libs/spirit/doc/html/spirit/qi/tutorials/number_list_attribute___one_more__with_style.html/trunk/libs/spirit/doc/html/spirit/qi/tutorials/number_list_redux___list_syntax.html

 /trunk/libs/spirit/doc/html/spirit/qi/tutorials/quick_start.html
 /trunk/libs/spirit/doc/html/spirit/qi/tutorials/roman_numerals.html
 /trunk/libs/spirit/doc/html/spirit/qi/tutorials/semantic_actions.html
 /trunk/libs/spirit/doc/html/spirit/qi/tutorials/sum___adding_numbers.html
 /trunk/libs/spirit/doc/html/spirit/qi/tutorials/warming_up.html
 /trunk/libs/spirit/doc/html/spirit/qi/tutorials.html
 /trunk/libs/spirit/doc/html/spirit/qi.html
 /trunk/libs/spirit/doc/html/spirit/repository.html
 /trunk/libs/spirit/doc/html/spirit/structure
 /trunk/libs/spirit/doc/html/spirit/structure/include.html
 /trunk/libs/spirit/doc/html/spirit/structure.html
 /trunk/libs/spirit/doc/html/spirit/support
 /trunk/libs/spirit/doc/html/spirit/support/multi_pass.html
 /trunk/libs/spirit/doc/html/spirit/support.html
 /trunk/libs/spirit/repository
 /trunk/libs/spirit/repository/doc
 /trunk/libs/spirit/repository/doc/html
 /trunk/libs/spirit/repository/doc/html/images
 /trunk/libs/spirit/repository/doc/html/images/alert.png
 /trunk/libs/spirit/repository/doc/html/images/callouts
 /trunk/libs/spirit/repository/doc/html/images/callouts/1.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/10.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/11.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/12.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/13.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/14.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/15.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/2.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/3.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/4.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/5.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/6.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/7.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/8.png
 /trunk/libs/spirit/repository/doc/html/images/callouts/9.png
 /trunk/libs/spirit/repository/doc/html/images/caution.png
 /trunk/libs/spirit/repository/doc/html/images/important.png
 /trunk/libs/spirit/repository/doc/html/images/note.png
 /trunk/libs/spirit/repository/doc/html/images/tip.png
 /trunk/libs/spirit/repository/doc/html/index.html
 /trunk/libs/spirit/repository/doc/html/spirit_repository
 /trunk/libs/spirit/repository/doc/html/spirit_repository/karma_components

/trunk/libs/spirit/repository/doc/html/spirit_repository/karma_components/directives/trunk/libs/spirit/repository/doc/html/spirit_repository/karma_components/directives/karma_confix_generator.html/trunk/libs/spirit/repository/doc/html/spirit_repository/karma_components/directives.html/trunk/libs/spirit/repository/doc/html/spirit_repository/karma_components/nonterminal/trunk/libs/spirit/repository/doc/html/spirit_repository/karma_components/nonterminal/subrule.html/trunk/libs/spirit/repository/doc/html/spirit_repository/karma_components/nonterminal.html/trunk/libs/spirit/repository/doc/html/spirit_repository/karma_components.html

 /trunk/libs/spirit/repository/doc/html/spirit_repository/preface.html
 /trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components

/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/directives/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/directives/confix.html/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/directives/distinct.html/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/directives.html/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/nonterminal/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/nonterminal/subrule.html/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/nonterminal.html/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/primitive/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/primitive/flush_multi_pass.html/trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components/primitive.html

 /trunk/libs/spirit/repository/doc/html/spirit_repository/qi_components.html
Deleted:
 /trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_attributes.html
 /trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_parsing.html
 /trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_states.html
 /trunk/libs/spirit/doc/html/spirit/notes/techniques.html
 /trunk/libs/spirit/doc/html/spirit/qi_and_karma
 /trunk/libs/spirit/doc/html/spirit/qi_and_karma.html
 /trunk/libs/spirit/doc/html/spirit/rationale.html
Modified:
 /trunk/libs/serialization/doc/acknowledgments.html
 /trunk/libs/serialization/doc/archive_reference.html
 /trunk/libs/serialization/doc/contents.html
 /trunk/libs/serialization/doc/exceptions.html
 /trunk/libs/serialization/doc/extended_type_info.html
 /trunk/libs/serialization/doc/rationale.html
 /trunk/libs/serialization/doc/special.html
 /trunk/libs/serialization/doc/traits.html
 /trunk/libs/spirit/doc/html/index.html
 /trunk/libs/spirit/doc/html/spirit/acknowledgments.html
 /trunk/libs/spirit/doc/html/spirit/faq.html
 /trunk/libs/spirit/doc/html/spirit/introduction.html

/trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_semantic_actions.html

 /trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_static_model.html
 /trunk/libs/spirit/doc/html/spirit/lex/abstracts/lexer_tokenizing.html
 /trunk/libs/spirit/doc/html/spirit/lex/abstracts.html
 /trunk/libs/spirit/doc/html/spirit/lex/quick_reference.html
 /trunk/libs/spirit/doc/html/spirit/lex/reference.html
 /trunk/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart1.html
 /trunk/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart2.html
 /trunk/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart3.html
 /trunk/libs/spirit/doc/html/spirit/lex/tutorials.html
 /trunk/libs/spirit/doc/html/spirit/lex.html
 /trunk/libs/spirit/doc/html/spirit/notes/porting_from_spirit_1_8_x.html
 /trunk/libs/spirit/doc/html/spirit/notes/style_guide.html
 /trunk/libs/spirit/doc/html/spirit/notes.html
 /trunk/libs/spirit/doc/html/spirit/references.html
 /trunk/libs/spirit/doc/html/spirit/what_s_new.html
 /trunk/libs/spirit/index.html
 /trunk/libs/spirit/phoenix/index.html

=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/alternative.png Thu Dec 3 23:11:442009

Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/and_predicate.png Thu Dec 323:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/callouts/Thumbs.db Thu Dec 323:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/double_performance.png Thu Dec 323:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/format_performance.png Thu Dec 323:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/int_performance.png Thu Dec 323:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null   
+++ /trunk/libs/spirit/doc/html/images/kleene.png       Thu Dec  3 23:11:44 2009
Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/lexerflow.png Thu Dec 3 23:11:442009

Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/non-terminal.png Thu Dec 3 23:11:442009

Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/not_predicate.png Thu Dec 323:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null   
+++ /trunk/libs/spirit/doc/html/images/optional.png     Thu Dec  3 23:11:44 2009
Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/pascal_string.png Thu Dec 323:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null   
+++ /trunk/libs/spirit/doc/html/images/plus.png Thu Dec  3 23:11:44 2009
Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/predicate.png Thu Dec 3 23:11:442009

Binary file, no diff available.
=======================================
--- /dev/null   
+++ /trunk/libs/spirit/doc/html/images/sequence.png     Thu Dec  3 23:11:44 2009
Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/images/start_stop.png Thu Dec 3 23:11:442009

Binary file, no diff available.
=======================================
--- /dev/null   
+++ /trunk/libs/spirit/doc/html/images/terminal.png     Thu Dec  3 23:11:44 2009
Binary file, no diff available.
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/abstracts/attributes/compound_attributes.htmlThu Dec 3 23:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/abstracts/attributes/more_compound_attributes.htmlThu Dec 3 23:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/abstracts/attributes/nonterminal_attributes.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,96 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Attributes of Rules and Grammars</title>

+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../attributes.html" title="Attributes">

+<link rel="prev" href="more_compound_attributes.html" title="More AboutAttributes of Compound Components">

+<link rel="next" href="../../qi.html" title="Qi - Writing Parsers">
+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+<td align="center"><ahref="../../../../../../libraries.htm">Libraries</a></td>+<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>+<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>+<td align="center"><ahref="../../../../../../../more/index.htm">More</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="more_compound_attributes.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../attributes.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="../../qi.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>
+<div class="section" title="Attributes of Rules and Grammars">
+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.abstracts.attributes.nonterminal_attributes"></a><aclass="link" href="nonterminal_attributes.html" title="Attributes of Rulesand Grammars">

+        Attributes of Rules and Grammars</a>
+</h4></div></div></div>
+<p>

+ Nonterminals are well known from parsers where they are used asthe main+ means of constructing more complex parsers out of simpler ones.The nonterminals+ in the parser world are very similar to functions in animperative programming+ language. They can be used to encapsulate parser expressions fora particular+ input sequence. After being defined, the nonterminals can beused as 'normal'+ parsers in more complex expressions whenever the encapsulatedinput needs+ to be recognized. Parser nonterminals in <spanclass="emphasis">Spirit.Qi+ may accept parameters(inherited attributes) and usually

+          return a value (the synthesized attribute).
+        </p>
+<p>

+ Both, the types of the inherited and the synthesized attributeshave to+ be explicitely specified while defining the particular <codeclass="computeroutput">grammar</code>+ or the <code class="computeroutput"><spanclass="identifier">rule</code> (the Spirit+ <a href="../../../../../repository/doc/html/index.html"target="_top">Repository</a> additionally+ has <code class="computeroutput"><spanclass="identifier">subrules</code> which conform+ to a similar interface). As an example, the following codedeclares a+ Spirit.Qi <codeclass="computeroutput">rule</code>+ exposing an <code class="computeroutput"><spanclass="keyword">int</code> as its synthesized+ attribute, while expecting a single <codeclass="computeroutput">double</code>+ as its inherited attribute (see the section about the <spanclass="emphasis">Spirit.Qi

+          Rule for more information):
+        </p>

+<pre class="programlisting">qi<spanclass="special">::rule<spanclass="special"><Iterator<spanclass="special">, int<spanclass="special">(double<spanclass="special">)> r<spanclass="special">;

+</pre>
+<p>

+ In the world of generators, nonterminals are just as useful asin the parser+ world. Generator nonterminals encapsulate a format descriptionfor a particular+ data type, and, whenever we need to emit output for this datatype, the+ corresponding nonterminal is invoked in a similar way as thepredefined+ Spirit.Karma generatorprimitives. The Spirit.Karma+ nonterminals are very similar to the <spanclass="emphasis">Spirit.Qi nonterminals.+ Generator nonterminals may accept <spanclass="emphasis">parameters as well,+ and we call those inherited attributes too. The main differenceis that+ they do not expose a synthesized attribute (as parsers do), butthey require+ a special consumedattribute. Usually the consumed+ attribute is the value the generator creates its output from.Even if the+ consumed attribute is not 'returned' from the generator we choseto use+ the same function style declaration syntax as used in <spanclass="emphasis">Spirit.Qi.+ The example below declares a <spanclass="emphasis">Spirit.Karma <codeclass="computeroutput">rule</code>consuming a <code class="computeroutput"><spanclass="keyword">double</code>

+          while not expecting any additional inherited attributes.
+        </p>

+<pre class="programlisting">karma<spanclass="special">::rule<spanclass="special"><<spanclass="identifier">OutputIterator,double()>r;

+</pre>
+<p>

+ The inherited attributes of nonterminal parsers and generatorsare normally+ passed to the component during its invocation. These are theparameters+ the parser or generator may accept and they can be used toparameterize

+          the component depending on the context they are invoked from.
+        </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+ Distributed under the Boost Software License, Version 1.0. (Seeaccompanying+ file LICENSE_1_0.txt or copy at <ahref="http://www.boost.org/LICENSE_1_0.txt";target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/abstracts/attributes/primitive_attributes.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,97 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Attributes of Primitive Components</title>

+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../attributes.html" title="Attributes">
+<link rel="prev" href="../attributes.html" title="Attributes">

+<link rel="next" href="compound_attributes.html" title="Attributes ofCompound Components">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="../attributes.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../attributes.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="compound_attributes.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>
+<div class="section" title="Attributes of Primitive Components">
+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.abstracts.attributes.primitive_attributes"></a><aclass="link" href="primitive_attributes.html" title="Attributes ofPrimitive Components">

+        Attributes of Primitive Components</a>
+</h4></div></div></div>
+<p>

+ Parsers and generators in <ahref="http://spirit.sourceforge.net"; target="_top">Spirit</a>+ are fully attributed. <spanclass="emphasis">Spirit.Qi parsers always <spanclass="emphasis">expose+ an attribute specific to their type. This is called <spanclass="emphasis">synthesized+ attribute as it is returned from a successful matchrepresenting+ the matched input sequence. For instance, numeric parsers, suchas <code class="computeroutput">int_</code>or <code class="computeroutput"><spanclass="identifier">double_</code>,+ return the <code class="computeroutput"><spanclass="keyword">int</code> or <code class="computeroutput"><spanclass="keyword">double</code> value converted from the matched+ input sequence. Other primitive parser components have otherintuitive+ attribute types, such as for instance <codeclass="computeroutput">int_</code>+ which has <code class="computeroutput"><spanclass="keyword">int</code>, or <code class="computeroutput"><spanclass="identifier">ascii::<spanclass="identifier">char_</code> which has <codeclass="computeroutput">char</code>.+ Forprimitive parsers apply the normal C++ convertibility rules:you can+ use any Other primitive parser components have other intuitiveattribute+ types, e.g. the parser <code class="computeroutput"><spanclass="identifier">ascii::<spanclass="identifier">char_</code>+ has <code class="computeroutput"><spanclass="keyword">char</code> as attribute type.+ For primitive parsers the normal C++ convertibility rules apply:you can+ use any C++ type to receive the parsed value as long as theattribute type+ of the parser is convertible to the type provided. The followingexample+ shows how a synthesized parser attribute (the <codeclass="computeroutput">int</code>+ value) is extracted by calling the API function <codeclass="computeroutput">qi<spanclass="special">::parse</code>:

+        </p>

+<pre class="programlisting">int <spanclass="identifier">value = <spanclass="number">0;+std::<spanclass="identifier">string str<spanclass="special">("123"<spanclass="special">);+qi::<spanclass="identifier">parse(<spanclass="identifier">str.<spanclass="identifier">begin(), <spanclass="identifier">str.<spanclass="identifier">end(), <spanclass="identifier">int_, <spanclass="identifier">value); <spanclass="comment">// value == 123

+</span></pre>
+<p>

+ The attribute type of a generator defines what data types thisgenerator+ is able to consume in order to produce its output. <spanclass="emphasis">Spirit.Karma+ generators always expectan attribute specific to+ their type. This is called consumedattribute and+ is expected to be passed to the generator. The consumedattribute is most+ of the time the value the generator is designed to emit outputfor. For+ primitive generators the normal C++ convertibility rules apply.Any data+ type convertible to the attribute type of a primitive generatorcan be+ used to provide the data to generate. We present a similarexample as above,+ this time the consumed attribute of the <codeclass="computeroutput">int_</code>+ generator (the <code class="computeroutput"><spanclass="keyword">int</code> value)+ is passed to the API function <code class="computeroutput"><spanclass="identifier">karma::<spanclass="identifier">generate</code>:

+        </p>

+<pre class="programlisting">int <spanclass="identifier">value = <spanclass="number">123;+std::<spanclass="identifier">string str<spanclass="special">;+std::<spanclass="identifier">back_insert_iterator<spanclass="special"><std<spanclass="special">::string<spanclass="special">> out<spanclass="special">(str<spanclass="special">);+karma::<spanclass="identifier">generate(<spanclass="identifier">out, <spanclass="identifier">int_, <spanclass="identifier">value<spanclass="special">); // str== "123"

+</span></pre>
+<p>

+ Other primitive generator components have other intuitiveattribute types,+ very similar to the corresponding parser components. Forinstance, the+ <code class="computeroutput"><spanclass="identifier">ascii::<spanclass="identifier">char_</code> generator has <codeclass="computeroutput">char</code>+ as consumed attribute. For a full list of available parser andgenerator+ primitives and their attribute types please see the sections <aclass="link" href="../../qi/quick_reference/qi_parsers.html" title="QiParsers">Qi+ Parsers</a> and <a class="link"href="../../karma/quick_reference/primitive_generators.html" title="KarmaGenerators">Karma

+          Generators</a>.
+        </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/abstracts/attributes.html Thu Dec 323:11:44 2009

@@ -0,0 +1,54 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Attributes</title>

+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">

+<link rel="prev" href="parsing_expression_grammar.html" title="ParsingExpression Grammar">+<link rel="next" href="attributes/primitive_attributes.html"title="Attributes of Primitive Components">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../index.html">Home</a></td>

+<td align="center"><ahref="../../../../../libraries.htm">Libraries</a></td>+<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>+<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>

+<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="parsing_expression_grammar.html"><imgsrc="../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../abstracts.html"><imgsrc="../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../index.html"><imgsrc="../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="attributes/primitive_attributes.html"><imgsrc="../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>
+<div class="section" title="Attributes">
+<div class="titlepage"><div><div><h3 class="title">

+<a name="spirit.abstracts.attributes"></a><a class="link"href="attributes.html" title="Attributes"> Attributes</a>

+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section"><a href="attributes/primitive_attributes.html">
+        Attributes of Primitive Components</a></span></dt>

+<dt><a href="attributes/compound_attributes.html">Attributes

+        of Compound Components</a></span></dt>

+<dt><ahref="attributes/more_compound_attributes.html">

+        More About Attributes of Compound Components</a></span></dt>
+<dt><span class="section"><a href="attributes/nonterminal_attributes.html">
+        Attributes of Rules and Grammars</a></span></dt>
+</dl></div>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/abstracts/parsing_expression_grammar.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,242 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Parsing Expression Grammar</title>

+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="syntax_diagram.html" title="Syntax Diagram">
+<link rel="next" href="attributes.html" title="Attributes">
+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../index.html">Home</a></td>

+<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="syntax_diagram.html"><imgsrc="../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../abstracts.html"><imgsrc="../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../index.html"><imgsrc="../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="attributes.html"><imgsrc="../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>
+<div class="section" title="Parsing Expression Grammar">
+<div class="titlepage"><div><div><h3 class="title">

+<a name="spirit.abstracts.parsing_expression_grammar"></a><a class="link"href="parsing_expression_grammar.html" title="Parsing ExpressionGrammar">Parsing

+      Expression Grammar</a>
+</h3></div></div></div>
+<p>
+        Parsing Expression Grammars (PEG)

+ [<a name="id604578" href="#ftn.id604578"class="footnote">6</a>]

+        are a derivative of Extended Backus-Naur Form (EBNF)

+ [<a name="id604590" href="#ftn.id604590"class="footnote">7</a>]+ with a different interpretation, designed to represent a recursivedescent+ parser. A PEG can be directly represented as a recursive-descentparser.

+      </p>
+<p>

+ Like EBNF, PEG is a formal grammar for describing a formallanguage in terms+ of a set of rules used to recognize strings of this language.Unlike EBNF,+ PEGs have an exact interpretation. There is only one valid parsetree (see

+        Abstract Syntax Tree) for each PEG grammar.
+      </p>
+<a name="spirit.abstracts.parsing_expression_grammar.sequences"></a><h5>
+<a name="id604610"></a>

+ <a class="link"href="parsing_expression_grammar.html#spirit.abstracts.parsing_expression_grammar.sequences">Sequences</a>

+      </h5>
+<p>
+        Sequences are represented by juxtaposition like in EBNF:
+      </p>

+<pre class="programlisting">a <spanclass="identifier">b

+</pre>
+<p>

+ The PEG expression above states that, in order for this tosucceed, <code class="computeroutput"><spanclass="identifier">b</code> must follow <codeclass="computeroutput">a</code>.

+        Here's the syntax diagram:
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/sequence.png" alt="sequence">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>
+        Here's a trivial example:
+      </p>

+<pre class="programlisting">'x' <spanclass="identifier">digit

+</pre>
+<p>

+ which means the character <code class="computeroutput"><spanclass="identifier">x</code>

+        must be followed by a digit.
+      </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ In Spirit.Qi, we use the<code class="computeroutput">>></code>+ for sequences since C++ does not allow juxtaposition, while inSpirit.Karma+ we use the <code class="computeroutput"><spanclass="special"><<</code> instead.

+        </p></td></tr>
+</table></div>
+<a name="spirit.abstracts.parsing_expression_grammar.alternatives"></a><h5>
+<a name="id605016"></a>

+ <a class="link"href="parsing_expression_grammar.html#spirit.abstracts.parsing_expression_grammar.alternatives">Alternatives</a>

+      </h5>
+<p>
+        Alternatives are represented in PEG using the slash:
+      </p>

+<pre class="programlisting">a <spanclass="special">/ b

+</pre>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ In Spirit.Qi and <spanclass="emphasis">Spirit.Karma,+ we use the <code class="computeroutput">|</code> for alternatives

+          just as in EBNF.
+        </p></td></tr>
+</table></div>
+<p>

+ Alternatives allow for choices. The expression above reads: try tomatch+ <code class="computeroutput"><spanclass="identifier">a</code>. If <code class="computeroutput"><spanclass="identifier">a</code>+ succeeds, success, if not try to match <codeclass="computeroutput">b</code>.+ This is a bit of a deviation from the usual EBNF interpretationwhere you+ simply match <code class="computeroutput"><spanclass="identifier">a</code> <spanclass="bold">or <code class="computeroutput"><spanclass="identifier">b</code>.

+        Here's the syntax diagram:
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/alternative.png" alt="alternative">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>

+ PEGs allow for ambiguity in the alternatives. In the expressionabove, both+ <code class="computeroutput"><spanclass="identifier">a</code> or <code class="computeroutput"><spanclass="identifier">b</code>+ can both match an input string. However, only the first matchingalternative

+        is valid. As noted, there can only be one valid parse tree.
+      </p>
+<a name="spirit.abstracts.parsing_expression_grammar.loops"></a><h5>
+<a name="id605162"></a>

+ <a class="link"href="parsing_expression_grammar.html#spirit.abstracts.parsing_expression_grammar.loops">Loops</a>

+      </h5>
+<p>

+ Again, like EBNF, PEG uses the regular-expression Kleene star andthe plus

+        loops:
+      </p>

+<pre class="programlisting">a<spanclass="special">*

+<span class="identifier">a</span><span class="special">+</span>
+</pre>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ Spirit.Qi and <spanclass="emphasis">Spirit.Karma use+ the prefix star and plus since there is no postfix star or plusin C++.

+        </p></td></tr>
+</table></div>
+<p>
+        Here are the syntax diagrams:
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/kleene.png" alt="kleene">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/plus.png" alt="plus">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>

+ The first, called the Kleene star, matches zero or more of itssubject <code class="computeroutput"><spanclass="identifier">a</code>. The second, plus, matches one ore more+ of its subject <code class="computeroutput"><spanclass="identifier">a</code>.

+      </p>
+<p>

+ Unlike EBNF, PEGs have greedy loops. It will match as much as itcan until+ its subject fails to match without regard to what follows. Thefollowing+ is a classic example of a fairly common EBNF/regex expressionfailing to

+        match in PEG:
+      </p>

+<pre class="programlisting">alnum<spanclass="special">* digit

+</pre>
+<p>

+ In PEG, alnum will eat as much alpha-numeric characters as it canleaving+ nothing more left behind. Thus, the trailing digit will getnothing. Loops+ are simply implemented in recursive descent code as for/whileloops making+ them extremely efficient. That is a definite advantage. On theother hand,+ those who are familiar with EBNF and regex behavior might find thebehavior+ a major gotcha. PEG provides a couple of other mechanisms tocircumvent this.

+        We will see more of these other mechanisms shortly.
+      </p>
+<a name="spirit.abstracts.parsing_expression_grammar.difference"></a><h5>
+<a name="id605310"></a>

+ <a class="link"href="parsing_expression_grammar.html#spirit.abstracts.parsing_expression_grammar.difference">Difference</a>

+      </h5>
+<p>

+ In some cases, you may want to restrict a certain expression. Youcan think+ of a PEG expression as a match for a potentially infinite set ofstrings.

+        The difference operator allows you to restrict this set:
+      </p>

+<pre class="programlisting">a <spanclass="special">- b

+</pre>
+<p>

+ The expression reads: match <code class="computeroutput"><spanclass="identifier">a</code>+ but not <code class="computeroutput"><spanclass="identifier">b</code>.

+      </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ There is no difference operator in <spanclass="emphasis">Spirit.Karma, as+ the concept does not make sense in the context of outputgeneration.

+        </p></td></tr>
+</table></div>
+<div class="footnotes">
+<br><hr width="100" align="left">

+<div class="footnote">[<a name="ftn.id604578" href="#id604578"class="para">6</a>] + Bryan Ford: Parsing Expression Grammars: A Recognition-BasedSyntactic+ Foundation, <ahref="http://pdos.csail.mit.edu/~baford/packrat/popl04/";target="_top">http://pdos.csail.mit.edu/~baford/packrat/popl04/</a>

+          </p></div>

+<div class="footnote">[<a name="ftn.id604590" href="#id604590"class="para">7</a>] + Richard E. Pattis: EBNF: A Notation to Describe Syntax, <ahref="http://www.cs.cmu.edu/~pattis/misc/ebnf.pdf";target="_top">http://www.cs.cmu.edu/~pattis/misc/ebnf.pdf</a>

+          </p></div>
+</div>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/abstracts/syntax_diagram.html ThuDec 3 23:11:44 2009

@@ -0,0 +1,247 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Syntax Diagram</title>

+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="../abstracts.html" title="Abstracts">

+<link rel="next" href="parsing_expression_grammar.html" title="ParsingExpression Grammar">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../index.html">Home</a></td>

+<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="../abstracts.html"><imgsrc="../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../abstracts.html"><imgsrc="../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../index.html"><imgsrc="../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="parsing_expression_grammar.html"><imgsrc="../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>
+<div class="section" title="Syntax Diagram">
+<div class="titlepage"><div><div><h3 class="title">

+<a name="spirit.abstracts.syntax_diagram"></a><a class="link"href="syntax_diagram.html" title="Syntax Diagram">Syntax Diagram</a>

+</h3></div></div></div>
+<p>

+ In the next section, we will deal with Parsing Expression Grammars(PEG)+ [<a name="id604135" href="#ftn.id604135"class="footnote">3</a>]

+        , a variant of Extended Backus-Naur Form (EBNF)

+ [<a name="id604147" href="#ftn.id604147"class="footnote">4</a>]+ with a different interpretation. It is easier to understand PEGusing Syntax+ Diagrams. Syntax diagrams represent a grammar graphically. It wasused extensibly

+        by Niklaus Wirth

+ [<a name="id604159" href="#ftn.id604159"class="footnote">5</a>]+ in the "Pascal User Manual". Syntax Diagrams are easilyunderstandable+ by programmers due to their similarity to flow charts. Theisomorphism of+ the diagrams and functions make them ideal for representingRecursive Descent

+        parsers which are essentially mutually recursive functions.
+      </p>
+<p>

+ Historically, Parsing Expression Grammars have been used fordescribing grammars+ for parsers only (hence the name). In <ahref="http://spirit.sourceforge.net"; target="_top">Spirit</a>+ we use a very similar notation for output generation as well.Almost all+ the concepts described here are equally applicable both to <spanclass="emphasis">Spirit.Qi+ parsers and to Spirit.Karmagenerators.

+      </p>
+<a name="spirit.abstracts.syntax_diagram.elements"></a><h5>
+<a name="id604187"></a>

+ <a class="link"href="syntax_diagram.html#spirit.abstracts.syntax_diagram.elements">Elements</a>

+      </h5>
+<p>

+ All diagrams have one entry and one exit point. Arrows connect allpossible

+        paths through the grammar from the entry point to the exit point.
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/start_stop.png" alt="start_stop">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>

+ Terminals are represented by round boxes. Terminals are atomic andusually

+        represent plain characters, strings or tokens.
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/terminal.png" alt="terminal">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>

+ Non-terminals are represented by boxes. Diagrams are modularizedusing named+ non-terminals. A complex diagram can be broken down into a set ofnon-terminals.+ Non-terminals also allow recursion (i.e. a non-terminal can callitself).

+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/non-terminal.png" alt="non-terminal">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<a name="spirit.abstracts.syntax_diagram.constructs"></a><h5>
+<a name="id604286"></a>

+ <a class="link"href="syntax_diagram.html#spirit.abstracts.syntax_diagram.constructs">Constructs</a>

+      </h5>
+<p>
+        The most basic composition is the Sequence. B follows A:
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/sequence.png" alt="sequence">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>

+ The ordered choice henceforth we will call <spanclass="emphasis">alternatives.+ In PEG, ordered choice and alternatives are not quite the same.PEG allows+ ambiguity of choice where one or more branches can succeed. InPEG, in case

+        of ambiguity, the first one always wins.
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/alternative.png" alt="alternative">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>
+        The optional (zero-or-one):
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/optional.png" alt="optional">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>
+        Now, the loops. We have the zero-or-more and one-or-more:
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/kleene.png" alt="kleene">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/plus.png" alt="plus">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>

+ Take note that, as in PEG, these loops behave greedily. If thereis another+ 'A' just before the end-point, it will always fail because thepreceding+ loop has already exhausted all 'A's and there is nothing moreleft. This+ is a crucial difference between PEG and general Context FreeGrammars (CFGs).+ This behavior is quite obvious with syntax diagrams as theyresemble flow-charts.

+      </p>
+<a name="spirit.abstracts.syntax_diagram.predicates"></a><h5>
+<a name="id604447"></a>

+ <a class="link"href="syntax_diagram.html#spirit.abstracts.syntax_diagram.predicates">Predicates</a>

+      </h5>
+<p>

+ Now, the following are Syntax Diagram versions of PEG predicates.These are+ not traditionally found in Syntax Diagrams. These are specialextensions

+        we invented to closely follow PEGs.
+      </p>
+<p>
+        First, we introduce a new element, the Predicate:
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/predicate.png" alt="predicate">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>

+ This is similar to the conditionals in flow charts where the 'No'branch

+        is absent and always signals a failed parse.
+      </p>
+<p>

+ We have two versions of the predicate, the <spanclass="emphasis">And-Predicate

+        and the <span class="emphasis"><em>Not-Predicate</em></span>:
+      </p>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/and_predicate.png" alt="and_predicate">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+          </p>
+<p>

+ <imgsrc="../.././images/not_predicate.png" alt="not_predicate">

+          </p>
+<p>
+        </p>
+</blockquote></div>
+<p>

+ The And-Predicate tries thepredicate, P, and succeeds+ if P succeeds, or otherwise fail. The opposite is true with theNot-Predicate.+ It tries the predicate, P, and fails if P succeeds, or otherwisesucceeds.+ Both versions do a look-ahead but do not consume any inputregardless if

+        P succeeds or not.
+      </p>
+<div class="footnotes">
+<br><hr width="100" align="left">

+<div class="footnote">[<a name="ftn.id604135" href="#id604135"class="para">3</a>] + Bryan Ford: Parsing Expression Grammars: A Recognition-BasedSyntactic+ Foundation, <ahref="http://pdos.csail.mit.edu/~baford/packrat/popl04/";target="_top">http://pdos.csail.mit.edu/~baford/packrat/popl04/</a>

+          </p></div>

+<div class="footnote">[<a name="ftn.id604147" href="#id604147"class="para">4</a>] + Richard E. Pattis: EBNF: A Notation to Describe Syntax, <ahref="http://www.cs.cmu.edu/~pattis/misc/ebnf.pdf";target="_top">http://www.cs.cmu.edu/~pattis/misc/ebnf.pdf</a>

+          </p></div>

+<div class="footnote">[<a name="ftn.id604159" href="#id604159"class="para">5</a>] 

+            Niklaus Wirth: The Programming Language Pascal. (July 1973)
+          </p></div>
+</div>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/abstracts.html Thu Dec 3 23:11:442009

@@ -0,0 +1,60 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Abstracts</title>

+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="structure/include.html" title="Include">

+<link rel="next" href="abstracts/syntax_diagram.html" title="SyntaxDiagram">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../index.html">Home</a></td>
+<td align="center"><a href="../../../../libraries.htm">Libraries</a></td>

+<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>+<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>

+<td align="center"><a href="../../../../../more/index.htm">More</a></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="structure/include.html"><imgsrc="../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../index.html"><imgsrc="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h"href="../index.html"><img src="../../../../../doc/html/images/home.png"alt="Home"></a><a accesskey="n" href="abstracts/syntax_diagram.html"><imgsrc="../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>
+<div class="section" title="Abstracts">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">

+<a name="spirit.abstracts"></a><a class="link" href="abstracts.html"title="Abstracts">Abstracts</a>

+</h2></div></div></div>
+<div class="toc"><dl>

+<dt><a href="abstracts/syntax_diagram.html">SyntaxDiagram</a></dt>+<dt><ahref="abstracts/parsing_expression_grammar.html">Parsing

+      Expression Grammar</a></span></dt>

+<dt><a href="abstracts/attributes.html">Attributes</a></dt>

+<dd><dl>

+<dt><ahref="abstracts/attributes/primitive_attributes.html">

+        Attributes of Primitive Components</a></span></dt>

+<dt><ahref="abstracts/attributes/compound_attributes.html"> Attributes

+        of Compound Components</a></span></dt>

+<dt><ahref="abstracts/attributes/more_compound_attributes.html">

+        More About Attributes of Compound Components</a></span></dt>

+<dt><ahref="abstracts/attributes/nonterminal_attributes.html">

+        Attributes of Rules and Grammars</a></span></dt>
+</dl></dd>
+</dl></div>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/assign_to/assign_to_attribute_from_iterators.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,331 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>Store an Attribute after a Parser Produced a Pair of Iterators(Qi)</title>+<link rel="stylesheet"href="../../../../../../../../doc/html/boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../assign_to.html" title="Store a Parsed AttributeValue (Qi)">+<link rel="prev" href="../assign_to.html" title="Store a Parsed AttributeValue (Qi)">+<link rel="next" href="assign_to_attribute_from_value.html" title="Storean Attribute Value after a Parser Produced a Value (Qi)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../../boost.png"></td>+<td align="center"><ahref="../../../../../../../../index.html">Home</a></td>+<td align="center"><ahref="../../../../../../../libraries.htm">Libraries</a></td>+<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>+<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>+<td align="center"><ahref="../../../../../../../../more/index.htm">More</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="../assign_to.html"><imgsrc="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../assign_to.html"><imgsrc="../../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../../index.html"><imgsrc="../../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="assign_to_attribute_from_value.html"><imgsrc="../../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Store an Attribute after a Parser Produced aPair of Iterators (Qi)">

+<div class="titlepage"><div><div><h5 class="title">

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators"></a><aclass="link" href="assign_to_attribute_from_iterators.html" title="Store anAttribute after a Parser Produced a Pair of Iterators (Qi)">+ Store an Attribute after a Parser Produced a Pair of Iterators(Qi)</a>

+</h5></div></div></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.assign_to_attribute_from_iterators"></a><h6>

+<a name="id946698"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.assign_to_attribute_from_iterators">assign_to_attribute_from_iterators</a>

+          </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">assign_to_attribute_from_iterators</code>+ is a type used as an attribute customization point. It isinvoked by+ the those Qi parsersnot producing any attribute+ value but returning a pair of iterators pointing to thematched input+ sequence. It is used to either store the iterator pair intothe attribute+ instance provided by the user or to convert the iterator pairinto an

+            attribute as provided by the user.
+          </p>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.module_headers"></a><h6>

+<a name="id946726"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.module_headers">Module

+            Headers</a>
+          </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/qi<spanclass="special">/detail<spanclass="special">/assign_to<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link"href="../../../structure/include.html" title="Include">IncludeStructure</a>.

+          </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly byany user+ program as it is normally included by other Spirit headerfiles relying

+              on its content.
+            </p></td></tr>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.namespace"></a><h6>

+<a name="id946818"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.namespace">Namespace</a>

+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                  <p>
+                    Name
+                  </p>
+                  </th></tr></thead>
+<tbody><tr><td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">spirit::<spanclass="identifier">traits</code>

+                  </p>
+                  </td></tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.synopsis"></a><h6>

+<a name="id946891"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.synopsis">Synopsis</a>

+          </h6>

+<span class="special">{</span>

+ static voidcall(<spanclass="identifier">Iterator const<spanclass="special">& first<spanclass="special">, Iterator <spanclass="keyword">const& <spanclass="identifier">last, <spanclass="identifier">Attrib& <spanclass="identifier">attr);

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.template_parameters"></a><h6>

+<a name="id947052"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.template_parameters">Template

+            parameters</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Parameter
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Description
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Default
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                    is the type of the attribute as passed in by the user.
+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Iterator</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Iterator</code>

+                    is the type of the iterators as produced by the parser.
+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput"><spanclass="identifier">assign_to_attribute_from_value</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                  </p>
+                  </td>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.notation"></a><h6>

+<a name="id947252"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.notation">Notation</a>

+          </h6>
+<div class="variablelist" title="Notation">
+<p class="title"><b>Notation</b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">Attrib</code></dt>

+<dd><p>

+ A type to be used as the target to store the attributevalue in.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">attr</code></dt>

+<dd><p>

+ A attribute instance of type <codeclass="computeroutput">Attrib</code>.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">Iterator</code></dt>

+<dd><p>

+ The iterator type used by the parser. This type usuallycorresponds

+                to the iterators as passed in by the user.
+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">begin</code>,+ <code class="computeroutput"><spanclass="identifier">end</code></dt>

+<dd><p>

+ Iterator instances of type <codeclass="computeroutput">Iterator</code>+ pointing to the begin and the end of the matched inputsequence.

+              </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.expression_semantics"></a><h6>

+<a name="id947366"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.expression_semantics">Expression

+            Semantics</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Expression
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                  <p>
+
+</p>

+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";class="table-programlisting"><spanclass="identifier">assign_to_attribute_from_iterators<spanclass="special"><Attrib<spanclass="special">, Iterator<spanclass="special">>::call<spanclass="special">(b<spanclass="special">, e<spanclass="special">, attr<spanclass="special">)</pre>

+<p>
+                  </p>
+                  </td>
+<td>
+                  <p>

+ Use the iterators <code class="computeroutput"><spanclass="identifier">begin</code>+ and <code class="computeroutput"><spanclass="identifier">end</code> to initialize+ the attribute <code class="computeroutput"><spanclass="identifier">attr</code>.

+                  </p>
+                  </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.predefined_specializations"></a><h6>

+<a name="id947509"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.predefined_specializations">Predefined

+            Specializations</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Template Parameters
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>, <code class="computeroutput"><spanclass="identifier">Iterator</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Execute an assignment <codeclass="computeroutput">attr+ = <spanclass="identifier">Attrib(<spanclass="identifier">begin, <spanclass="identifier">end)</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>,+ <code class="computeroutput"><spanclass="identifier">T</code>

+                  </p>
+                  </td>
+<td>
+                  <p>
+                    Do nothing.
+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.when_to_implement"></a><h6>

+<a name="id947656"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.when_to_implement">When

+            to implement</a>
+          </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">assign_to_attribute_from_iterators</code>+ needs to be implemented for a specific type whenever thedefault implementation+ as shown above is not applicable. Examples for this could bethat the+ type <code class="computeroutput"><spanclass="identifier">Attrib</code> is not constructible

+            from the pair of iterators.
+          </p>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.example"></a><h6>

+<a name="id947687"></a>

+ <a class="link"href="assign_to_attribute_from_iterators.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_iterators.example">Example</a>

+          </h6>
+<p>
+            TBD
+          </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/assign_to/assign_to_attribute_from_value.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,325 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>Store an Attribute Value after a Parser Produced a Value(Qi)</title>+<link rel="stylesheet"href="../../../../../../../../doc/html/boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../assign_to.html" title="Store a Parsed AttributeValue (Qi)">+<link rel="prev" href="assign_to_attribute_from_iterators.html"title="Store an Attribute after a Parser Produced a Pair of Iterators (Qi)">+<link rel="next" href="../store_value.html" title="Store Parsed AttributeValues into a Container (Qi)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="assign_to_attribute_from_iterators.html"><imgsrc="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../assign_to.html"><imgsrc="../../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../../index.html"><imgsrc="../../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="../store_value.html"><imgsrc="../../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Store an Attribute Value after a ParserProduced a Value (Qi)">

+<div class="titlepage"><div><div><h5 class="title">

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value"></a><aclass="link" href="assign_to_attribute_from_value.html" title="Store anAttribute Value after a Parser Produced a Value (Qi)">

+          Store an Attribute Value after a Parser Produced a Value (Qi)</a>
+</h5></div></div></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.assign_to_attribute_from_value"></a><h6>

+<a name="id947714"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.assign_to_attribute_from_value">assign_to_attribute_from_value</a>

+          </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">assign_to_attribute_from_value</code>+ is a type used as an attribute customization point. It isinvoked by+ the all primitive Qiparsers in order to store a+ parsed attribute value into the attribute instance provided bythe user.

+          </p>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.module_headers"></a><h6>

+<a name="id947742"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.module_headers">Module

+            Headers</a>
+          </h6>

+</pre>
+<p>

+ Also, see <a class="link"href="../../../structure/include.html" title="Include">IncludeStructure</a>.

+          </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly byany user+ program as it is normally included by other Spirit headerfiles relying

+              on its content.
+            </p></td></tr>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.namespace"></a><h6>

+<a name="id947834"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.namespace">Namespace</a>

+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                  <p>
+                    Name
+                  </p>
+                  </th></tr></thead>
+<tbody><tr><td>
+                  <p>

+                  </p>
+                  </td></tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.synopsis"></a><h6>

+<a name="id947908"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.synopsis">Synopsis</a>

+          </h6>

+<span class="special">{</span>

+ static voidcall(<spanclass="identifier">T const<spanclass="special">& val<spanclass="special">, Attrib<spanclass="special">& attr<spanclass="special">);

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.template_parameters"></a><h6>

+<a name="id951967"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.template_parameters">Template

+            parameters</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Parameter
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Description
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Default
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                    is the type of the attribute as passed in by the user.
+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">T</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">T</code> is+ the type of the attribute instance as produced by theparser.

+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.notation"></a><h6>

+<a name="id952168"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.notation">Notation</a>

+          </h6>
+<div class="variablelist" title="Notation">
+<p class="title"><b>Notation</b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">Attrib</code></dt>

+<dd><p>

+ A type to be used as the target to store the attributevalue in.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">attr</code></dt>

+<dd><p>

+ A attribute instance of type <codeclass="computeroutput">Attrib</code>.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">T</code></dt>

+<dd><p>

+ A type as produced by the parser. The parser temporarilystores its

+                parsed values using this type.
+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">t</code></dt>

+<dd><p>

+ A attribute instance of type <codeclass="computeroutput">T</code>.

+              </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.expression_semantics"></a><h6>

+<a name="id952275"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.expression_semantics">Expression

+            Semantics</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Expression
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                  <p>
+
+</p>

+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";class="table-programlisting"><spanclass="identifier">assign_to_attribute_from_value<spanclass="special"><Attrib<spanclass="special">, T<spanclass="special">>::call<spanclass="special">(t<spanclass="special">, attr<spanclass="special">)</pre>

+<p>
+                  </p>
+                  </td>
+<td>
+                  <p>

+ Copy (assign) the value, <codeclass="computeroutput">t</code>+ to the attribute <code class="computeroutput"><spanclass="identifier">attr</code>.

+                  </p>
+                  </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.predefined_specializations"></a><h6>

+<a name="id952402"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.predefined_specializations">Predefined

+            Specializations</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Template Parameters
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>, <code class="computeroutput"><spanclass="identifier">T</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Assign the argument <code class="computeroutput"><spanclass="identifier">t</code>+ to <code class="computeroutput"><spanclass="identifier">attr</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>,+ <code class="computeroutput"><spanclass="identifier">T</code>

+                  </p>
+                  </td>
+<td>
+                  <p>
+                    Do nothing.
+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.when_to_implement"></a><h6>

+<a name="id952527"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.when_to_implement">When

+            to implement</a>
+          </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">assign_to_attribute_from_value</code>+ needs to be implemented for a specific type whenever thedefault implementation+ as shown above is not applicable. Examples for this could bethat the+ type <code class="computeroutput"><spanclass="identifier">Attrib</code> is not copy

+            constructible.
+          </p>

+<aname="spirit.advanced.customize.assign_to.assign_to_attribute_from_value.example"></a><h6>

+<a name="id952558"></a>

+ <a class="link"href="assign_to_attribute_from_value.html#spirit.advanced.customize.assign_to.assign_to_attribute_from_value.example">Example</a>

+          </h6>
+<p>
+            TBD
+          </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/advanced/customize/assign_to.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,59 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Store a Parsed Attribute Value (Qi)</title>

+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../customize.html" title="Customization of Spirit'sAttribute Handling">+<link rel="prev" href="transform.html" title="Transform an Attribute to aDifferent Type (Qi and Karma)">+<link rel="next" href="assign_to/assign_to_attribute_from_iterators.html"title="Store an Attribute after a Parser Produced a Pair of Iterators (Qi)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="transform.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../customize.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="assign_to/assign_to_attribute_from_iterators.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>
+<div class="section" title="Store a Parsed Attribute Value (Qi)">
+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.advanced.customize.assign_to"></a><a class="link"href="assign_to.html" title="Store a Parsed Attribute Value (Qi)"> Store aParsed

+        Attribute Value (Qi)</a>
+</h4></div></div></div>
+<div class="toc"><dl>

+<dt><ahref="assign_to/assign_to_attribute_from_iterators.html">+ Store an Attribute after a Parser Produced a Pair of Iterators(Qi)</a></dt>+<dt><ahref="assign_to/assign_to_attribute_from_value.html">+ Store an Attribute Value after a Parser Produced a Value(Qi)</a></dt>

+</dl></div>
+<p>

+ After parsing input and generting an attribute value this valueneeds to+ assigned to the attribute instance provided by the user. Thecustomization+ points <code class="computeroutput"><spanclass="identifier">assign_to_attribute_from_iterators</code>+ and <code class="computeroutput"><spanclass="identifier">assign_to_attribute_from_value</code>+ are utilized to adapt this assignment to the concrete type to beassigned.

+          This section describes both.
+        </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/advanced/customize/clear_value.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,369 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Re-Initialize an Attribute Value before Parsing (Qi)</title>

+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../customize.html" title="Customization of Spirit'sAttribute Handling">+<link rel="prev" href="store_value/push_back.html" title="Store a ParsedAttribute Value into a Container (Qi)">+<link rel="next" href="extract_from.html" title="Extract an AttributeValue to Generate Output (Karma)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="store_value/push_back.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../customize.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="extract_from.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Re-Initialize an Attribute Value beforeParsing (Qi)">

+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.advanced.customize.clear_value"></a><a class="link"href="clear_value.html" title="Re-Initialize an Attribute Value beforeParsing (Qi)"> Re-Initialize

+        an Attribute Value before Parsing (Qi)</a>
+</h4></div></div></div>
+<a name="spirit.advanced.customize.clear_value.clear_value"></a><h6>
+<a name="id955679"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.clear_value">clear_value</a>

+        </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">clear_value</code>+ is a type used as an attribute customization point. It isinvoked by the+ Qi repetitive parsers (<aclass="link" href="../../qi/reference/operator/kleene.html" title="Kleene(*a)">Kleene</a>,+ <a class="link" href="../../qi/reference/operator/plus.html"title="Plus (+a)">Plus</a>, <a class="link"href="../../qi/reference/operator/list.html" title="List (a % b)">List</a>,+ and <a class="link"href="../../qi/reference/directive/repeat.html" title="Repetition(repeat[])">Repeat</a>)+ in order to re-initialize the attribute instance passed to theembedded+ parser after it has been stored in the provided container. Thisre-initialized+ attribute instance is reused during the next iteration of therepetitive

+          parser.
+        </p>
+<a name="spirit.advanced.customize.clear_value.module_headers"></a><h6>
+<a name="id955726"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.module_headers">Module

+          Headers</a>
+        </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/support<spanclass="special">/attributes<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link" href="../../structure/include.html"title="Include">Include Structure</a>.

+        </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly by anyuser program+ as it is normally included by other Spirit header filesrelying on its

+            content.
+          </p></td></tr>
+</table></div>
+<a name="spirit.advanced.customize.clear_value.namespace"></a><h6>
+<a name="id955811"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.namespace">Namespace</a>

+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                <p>
+                  Name
+                </p>
+                </th></tr></thead>
+<tbody><tr><td>
+                <p>

+                </p>
+                </td></tr></tbody>
+</table></div>
+<a name="spirit.advanced.customize.clear_value.synopsis"></a><h6>
+<a name="id955884"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.synopsis">Synopsis</a>

+        </h6>

+<span class="special">{</span>

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.clear_value.template_parameters"></a><h6>

+<a name="id955991"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.template_parameters">Template

+          parameters</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Parameter
+                </p>
+                </th>
+<th>
+                <p>
+                  Description
+                </p>
+                </th>
+<th>
+                <p>
+                  Default
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                </p>
+                </td>
+<td>
+                <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                  of the attribute to be re-initialized.
+                </p>
+                </td>
+<td>
+                <p>
+                  none
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput">clear_value</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                </p>
+                </td>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.clear_value.notation"></a><h6>
+<a name="id956157"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.notation">Notation</a>

+        </h6>
+<div class="variablelist" title="Notation">
+<p class="title"><b>Notation</b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">Attrib</code></dt>

+<dd><p>

+ A type to be used as a container to store attribute valuesin.

+            </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">attr</code></dt>

+<dd><p>

+ A attribute instance of type <codeclass="computeroutput">Attrib</code>.

+            </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">T1</code>,+ <code class="computeroutput"><spanclass="identifier">T2</code>, ...</dt>

+<dd><p>
+              Arbitrary types
+            </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.clear_value.expression_semantics"></a><h6>

+<a name="id956249"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.expression_semantics">Expression

+          Semantics</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Expression
+                </p>
+                </th>
+<th>
+                <p>
+                  Semantics
+                </p>
+                </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                <p>
+
+</p>

+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";class="table-programlisting"><spanclass="identifier">clear_value<<spanclass="identifier">Attrib>::<spanclass="identifier">call(<spanclass="identifier">Attrib& <spanclass="identifier">attr)</pre>

+<p>
+                </p>
+                </td>
+<td>
+                <p>

+ Re-initialize the instance referred to by <codeclass="computeroutput">attr</code>

+                  in the most efficient way.
+                </p>
+                </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.clear_value.predefined_specializations"></a><h6>

+<a name="id956366"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.predefined_specializations">Predefined

+          Specializations</a>
+        </h6>
+<p>

+        </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Template Parameters
+                </p>
+                </th>
+<th>
+                <p>
+                  Value
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Re-initialize using assignment of default constructedvalue.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ Any type <code class="computeroutput"><spanclass="identifier">T</code> for+ which <code class="computeroutput"><spanclass="identifier">is_container<spanclass="special"><>::type</code>+ is <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">true_</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Call the member function <codeclass="computeroutput">attr<spanclass="special">.clear<spanclass="special">()</code> for the passed attribute instance.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">optional<<spanclass="identifier">Attrib></code>

+                </p>
+                </td>
+<td>
+                <p>

+ Clear the <code class="computeroutput"><spanclass="identifier">optional</code>

+                  instance and leave it uninitialized.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">variant<<spanclass="identifier">T1,+ T2<spanclass="special">,

+                  <span class="special">...&gt;</span></code>
+                </p>
+                </td>
+<td>
+                <p>

+ Invoke the <code class="computeroutput"><spanclass="identifier">clear_value</code>

+                  customization point for the currently held value.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">fusion::<spanclass="identifier">tuple<<spanclass="identifier">T1,+ T2<spanclass="special">,

+                  <span class="special">...&gt;</span></code>
+                </p>
+                </td>
+<td>
+                <p>

+ Invoke the <code class="computeroutput"><spanclass="identifier">clear_value</code>

+                  customization point for all elements of the tuple.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>

+                </p>
+                </td>
+<td>
+                <p>
+                  Do nothing.
+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.clear_value.when_to_implement"></a><h6>
+<a name="id956719"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.when_to_implement">When

+          to Implement</a>
+        </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">clear_value</code>+ needs to be implemented for a specific type whenever this typeis to be+ used as an attribute to be stored into a STL container and ifthe type+ cannot be re-initialized using one of the specializations listedabove.+ Examples for this might be types not being default constructibleor container+ types not exposing a member function <codeclass="computeroutput">clear<spanclass="special">()</code>.

+        </p>
+<a name="spirit.advanced.customize.clear_value.example"></a><h6>
+<a name="id956754"></a>

+ <a class="link"href="clear_value.html#spirit.advanced.customize.clear_value.example">Example</a>

+        </h6>
+<p>
+          TBD
+        </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/advanced/customize/extract_from.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,355 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Extract an Attribute Value to Generate Output (Karma)</title>

+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../customize.html" title="Customization of Spirit'sAttribute Handling">+<link rel="prev" href="clear_value.html" title="Re-Initialize an AttributeValue before Parsing (Qi)">+<link rel="next" href="iterate.html" title="Extract Attribute Values toGenerate Output from a Container (Karma)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="clear_value.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../customize.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="iterate.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Extract an Attribute Value to Generate Output(Karma)">

+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.advanced.customize.extract_from"></a><a class="link"href="extract_from.html" title="Extract an Attribute Value to GenerateOutput (Karma)"> Extract an

+        Attribute Value to Generate Output (Karma)</a>
+</h4></div></div></div>
+<a name="spirit.advanced.customize.extract_from.extract_from"></a><h6>
+<a name="id956783"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.extract_from">extract_from</a>

+        </h6>
+<p>

+ Before generating output for a value this value needs toextracted from+ the attribute instance provided by the user. The customizationpoint <code class="computeroutput"><spanclass="identifier">extract_from</code> is utilized to adapt this+ extraction for any data type possibly used to store the valuesto output.

+        </p>
+<a name="spirit.advanced.customize.extract_from.module_headers"></a><h6>
+<a name="id956807"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.module_headers">Module

+          Headers</a>
+        </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/karma<spanclass="special">/detail<spanclass="special">/extract_from<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link" href="../../structure/include.html"title="Include">Include Structure</a>.

+        </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly by anyuser program+ as it is normally included by other Spirit header filesrelying on its

+            content.
+          </p></td></tr>
+</table></div>
+<a name="spirit.advanced.customize.extract_from.namespace"></a><h6>
+<a name="id956899"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.namespace">Namespace</a>

+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                <p>
+                  Name
+                </p>
+                </th></tr></thead>
+<tbody><tr><td>
+                <p>

+                </p>
+                </td></tr></tbody>
+</table></div>
+<a name="spirit.advanced.customize.extract_from.synopsis"></a><h6>
+<a name="id956972"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.synopsis">Synopsis</a>

+        </h6>

+<span class="special">{</span>

+ template <spanclass="special"><typename <spanclass="identifier">Context>+ static <spanclass="identifier">type call<spanclass="special">(Attrib <spanclass="keyword">const& <spanclass="identifier">attr, <spanclass="identifier">Context& <spanclass="identifier">context);

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.extract_from.template_parameters"></a><h6>

+<a name="id957147"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.template_parameters">Template

+          parameters</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Parameter
+                </p>
+                </th>
+<th>
+                <p>
+                  Description
+                </p>
+                </th>
+<th>
+                <p>
+                  Default
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                </p>
+                </td>
+<td>
+                <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                  of the attribute to be used to generate output from.
+                </p>
+                </td>
+<td>
+                <p>
+                  none
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                </p>
+                </td>
+<td>
+                <p>

+                </p>
+                </td>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Context</code>

+                </p>
+                </td>
+<td>
+                <p>

+ This is the type of the current generator executioncontext.

+                </p>
+                </td>
+<td class="auto-generated"> </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.extract_from.notation"></a><h6>
+<a name="id957337"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.notation">Notation</a>

+        </h6>
+<div class="variablelist" title="Notation">
+<p class="title"><b>Notation</b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">Attrib</code></dt>

+<dd><p>
+              A type to be used to generate output from.
+            </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">attr</code></dt>

+<dd><p>

+ A attribute instance of type <codeclass="computeroutput">Attrib</code>.

+            </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.extract_from.expression_semantics"></a><h6>

+<a name="id957403"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.expression_semantics">Expression

+          Semantics</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Expression
+                </p>
+                </th>
+<th>
+                <p>
+                  Semantics
+                </p>
+                </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                <p>
+
+</p>

+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";class="table-programlisting"><spanclass="identifier">extract_from_attribute<spanclass="special"><Attrib<spanclass="special">>::call<spanclass="special">(attr<spanclass="special">, ctx<spanclass="special">)</pre>

+<p>
+                </p>
+                </td>
+<td>
+                <p>

+ Extract the value to generate output from and return itto the

+                  caller.
+                </p>
+                </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.extract_from.predefined_specializations"></a><h6>

+<a name="id957510"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.predefined_specializations">Predefined

+          Specializations</a>
+        </h6>
+<p>

+        </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Template Parameters
+                </p>
+                </th>
+<th>
+                <p>
+                  Value
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                </p>
+                </td>
+<td>
+                <p>

+ The exposed typedef <code class="computeroutput"><spanclass="identifier">type</code>+ is defined to <code class="computeroutput"><spanclass="identifier">Attrib+ const<spanclass="special">&</code>.+ The function <code class="computeroutput"><spanclass="identifier">call()</code>returns the argument by reference

+                  without change.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+                </p>
+                </td>
+<td>
+                <p>

+                  argument by reference without change.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">reference_wrapper<spanclass="special"><Attrib<spanclass="special">></code>

+                </p>
+                </td>
+<td>
+                <p>

+                  change.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>

+                </p>
+                </td>
+<td>
+                <p>

+ The exposed typedef <code class="computeroutput"><spanclass="identifier">type</code>+ is defined to <code class="computeroutput"><spanclass="identifier">unused_type</code>.+ The function <code class="computeroutput"><spanclass="identifier">call()</code>returns an instance of <code class="computeroutput"><spanclass="identifier">unused_type</code>.

+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.extract_from.when_to_implement"></a><h6>
+<a name="id957854"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.when_to_implement">When

+          to implement</a>
+        </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">extract_from_attribute</code>+ needs to be implemented for a specific type whenever the defaultimplementation+ as shown above is not applicable. Examples for this could bethat the type+ to be extracted is different from <codeclass="computeroutput">Attrib</code>

+          and is not copy constructible.
+        </p>
+<a name="spirit.advanced.customize.extract_from.example"></a><h6>
+<a name="id957888"></a>

+ <a class="link"href="extract_from.html#spirit.advanced.customize.extract_from.example">Example</a>

+        </h6>
+<p>
+          TBD
+        </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/advanced/customize/is_container.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,503 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>Determine if a Type Should be Treated as a Container (Qi andKarma)</title>+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../customize.html" title="Customization of Spirit'sAttribute Handling">+<link rel="prev" href="../customize.html" title="Customization of Spirit'sAttribute Handling">+<link rel="next" href="transform.html" title="Transform an Attribute to aDifferent Type (Qi and Karma)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="../customize.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../customize.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="transform.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Determine if a Type Should be Treated as aContainer (Qi and Karma)">

+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.advanced.customize.is_container"></a><a class="link"href="is_container.html" title="Determine if a Type Should be Treated as aContainer (Qi and Karma)"> Determine

+        if a Type Should be Treated as a Container (Qi and Karma)</a>
+</h4></div></div></div>
+<a name="spirit.advanced.customize.is_container.is_container"></a><h6>
+<a name="id940739"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.is_container">is_container</a>

+        </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">is_container</code>+ is a template meta-function used as an attribute customizationpoint. It+ is invoked by the Qi <aclass="link" href="../../qi/reference/operator/sequence.html"title="Sequence (a >> b)">Sequence</a>+ (<code class="computeroutput"><spanclass="special">>></code>) and <spanclass="emphasis">Karma+ <a class="link"href="../../karma/reference/operator/sequence.html" title="Sequences (a<< b)">Sequence (<code class="computeroutput"><spanclass="special"><<</code>)</a> operators in order to determine+ whether a supplied attribute can potentially be treated as acontainer.

+        </p>
+<a name="spirit.advanced.customize.is_container.header"></a><h6>
+<a name="id940794"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.header">Header</a>

+        </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/support<spanclass="special">/container<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link" href="../../structure/include.html"title="Include">Include Structure</a>.

+        </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly by anyuser program+ as it is normally included by other Spirit header filesrelying on its

+            content.
+          </p></td></tr>
+</table></div>
+<a name="spirit.advanced.customize.is_container.namespace"></a><h6>
+<a name="id940879"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.namespace">Namespace</a>

+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                <p>
+                  Name
+                </p>
+                </th></tr></thead>
+<tbody><tr><td>
+                <p>

+                </p>
+                </td></tr></tbody>
+</table></div>
+<a name="spirit.advanced.customize.is_container.synopsis"></a><h6>
+<a name="id940952"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.synopsis">Synopsis</a>

+        </h6>

+<span class="special">{</span>

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.is_container.template_parameters"></a><h6>

+<a name="id941051"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.template_parameters">Template

+          parameters</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Parameter
+                </p>
+                </th>
+<th>
+                <p>
+                  Description
+                </p>
+                </th>
+<th>
+                <p>
+                  Default
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Container</code>

+                </p>
+                </td>
+<td>
+                <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Container</code>+ which needs to be tested whether it has to be treated asa container

+                </p>
+                </td>
+<td>
+                <p>
+                  none
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput">is_container</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                </p>
+                </td>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.is_container.notation"></a><h6>
+<a name="id941216"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.notation">Notation</a>

+        </h6>
+<div class="variablelist">
+<p class="title"><b></b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">C</code></dt>

+<dd><p>

+ A type to be tested whether it needs to be treated as acontainer.

+            </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">T1</code>,+ <code class="computeroutput"><spanclass="identifier">T2</code>, ...</dt>

+<dd><p>
+              Arbitrary types
+            </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.is_container.expression_semantics"></a><h6>

+<a name="id941282"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.expression_semantics">Expression

+          Semantics</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Expression
+                </p>
+                </th>
+<th>
+                <p>
+                  Semantics
+                </p>
+                </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">is_container<spanclass="special"><C<spanclass="special">>::type</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Result of the metafunction that evaluates to <codeclass="computeroutput">mpl<spanclass="special">::true_</code>+ if a given type, <code class="computeroutput"><spanclass="identifier">C</code>,+ is to be treated as a container, <codeclass="computeroutput">mpl<spanclass="special">::false_</code>+ otherwise (See <ahref="../../../../../../../libs/mpl/doc/refmanual/integral-constant.html"target="_top">MPL

+                  Boolean Constant</a>).
+                </p>
+                </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.is_container.predefined_specializations"></a><h6>

+<a name="id943082"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.predefined_specializations">Predefined

+          Specializations</a>
+        </h6>
+<p>

+ <a href="http://spirit.sourceforge.net"; target="_top">Spirit</a>predefines specializations+ of this customization point for several types. The followingtable lists+ those types together with the conditions for which thecorresponding specializations+ will evaluate to <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">true_</code> (see <ahref="../../../../../../../libs/mpl/doc/refmanual/integral-constant.html"target="_top">MPL

+          Boolean Constant</a>):
+        </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Template Parameters
+                </p>
+                </th>
+<th>
+                <p>
+                  Value
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">T</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Returns <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">true_</code> if <codeclass="computeroutput">T</code>+ has the following embedded types defined: <codeclass="computeroutput">value_type</code>,+ <code class="computeroutput"><spanclass="identifier">iterator</code>, <codeclass="computeroutput">size_type</code>,and<code class="computeroutput"><spanclass="identifier">reference</code>.+ Otherwise it will return <codeclass="computeroutput">mpl<spanclass="special">::false_</code>.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+                </p>
+                </td>
+<td>
+                <p>

+ Returns <code class="computeroutput"><spanclass="identifier">is_container<spanclass="special"><T<spanclass="special">>::type</code>

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+                  <span class="special">...&gt;</span></code>
+                </p>
+                </td>
+<td>
+                <p>

+ Returns <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">true_</code> if at least one of the+ <code class="computeroutput"><spanclass="identifier">is_container<spanclass="special"><TN<spanclass="special">>::type</code>returns <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">true_</code>+ (where <code class="computeroutput"><spanclass="identifier">TN</code> is <code class="computeroutput"><spanclass="identifier">T1</code>, <code class="computeroutput"><spanclass="identifier">T2</code>,+ ...). Otherwise it will return <codeclass="computeroutput">mpl<spanclass="special">::false_</code>.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Returns <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">false_</code>.

+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.is_container.when_to_implement"></a><h6>
+<a name="id943493"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.when_to_implement">When

+          to implement</a>
+        </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">is_container</code>+ needs to be implemented for a specific type whenever this typeis to be+ used as an attribute in place of a STL container. It isapplicable for+ parsers (Spirit.Qi) andgenerators (Spirit.Karma).+ As a rule of thumb: it has to be implemented whenever a certaintype is+ to be passed as an attribute to a parser or a generator normallyexposing+ a STL container, <code class="computeroutput"><spanclass="identifier">C</code> and+ if the type does not expose the interface of a STL container(i.e. <code class="computeroutput"><spanclass="identifier">is_container<spanclass="special"><C<spanclass="special">>::type</code>would normally return <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">false_</code>). These components have an attribute

+          propagation rule in the form:
+        </p>

+<pre class="programlisting">a<spanclass="special">: A <spanclass="special">--> Op<spanclass="special">(a<spanclass="special">): vector<spanclass="special"><A<spanclass="special">>

+</pre>
+<p>

+ where <code class="computeroutput"><spanclass="identifier">Op(<spanclass="identifier">a)</code> stands+ for any meaningful operation on the component <codeclass="computeroutput">a</code>.

+        </p>

+<aname="spirit.advanced.customize.is_container.related_attribute_customization_points"></a><h6>

+<a name="id943652"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.related_attribute_customization_points">Related

+          Attribute Customization Points</a>
+        </h6>
+<p>

+ If this customization point is implemented, the following othercustomization

+          points might need to be implemented as well.
+        </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Name
+                </p>
+                </th>
+<th>
+                <p>
+                  When to implement
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <a class="link" href="store_value/container_value.html"title="Determine the Type to be Stored in a Container (Qi)"><codeclass="computeroutput"><spanclass="identifier">container_value</code></a>

+                </p>
+                </td>
+<td>
+                <p>

+ Needs to be implemented whenever <codeclass="computeroutput">is_container</code>

+                  is implemented.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <a class="link" href="store_value/push_back.html"title="Store a Parsed Attribute Value into a Container (Qi)"><codeclass="computeroutput"><spanclass="identifier">push_back_container</code></a>

+                </p>
+                </td>
+<td>
+                <p>

+ Qi: <a class="link"href="../../qi/reference/operator/list.html" title="List (a % b)">List</a>,+ <a class="link"href="../../qi/reference/operator/kleene.html" title="Kleene(*a)">Kleene</a>,+ <a class="link"href="../../qi/reference/operator/plus.html" title="Plus (+a)">Plus</a>,+ <a class="link"href="../../qi/reference/directive/repeat.html" title="Repetition(repeat[])">Repeat</a>.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <a class="link" href="iterate/container_iterator.html"title="Determine the Type of the Iterator of a Container (Karma)"><codeclass="computeroutput"><spanclass="identifier">container_iterator</code></a>

+                </p>
+                </td>
+<td>
+                <p>

+ Karma: <a class="link"href="../../karma/reference/operator/list.html" title="Lists (a % b)">List+ (<code class="computeroutput"><spanclass="special">%</code>)</a>, <a class="link"href="../../karma/reference/operator/kleene.html" title="Kleene Star(*a)">Kleene (unary+ <code class="computeroutput"><spanclass="special">*</code>)</a>, <a class="link"href="../../karma/reference/operator/plus.html" title="Plus (+a)">Plus+ (unary <code class="computeroutput"><spanclass="special">+</code>)</a>,+ <a class="link"href="../../karma/reference/directive/repeat.html" title="RepetitionDirective (repeat[])">Repeat</a>.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <a class="link" href="iterate/begin_container.html"title="Get the Iterator pointing to the Begin of a ContainerAttribute"><code class="computeroutput"><spanclass="identifier">begin_container</code></a>

+                </p>
+                </td>
+<td>
+                <p>

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <a class="link" href="iterate/end_container.html"title="Get the Iterator pointing to the End of a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">end_container</code></a>

+                </p>
+                </td>
+<td>
+                <p>

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <a class="link" href="iterate/deref_iterator.html"title="Dereference the Iterator pointing into a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">deref_iterator</code></a>

+                </p>
+                </td>
+<td>
+                <p>

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <a class="link" href="iterate/next_iterator.html"title="Increment the Iterator pointing into a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">next_iterator</code></a>

+                </p>
+                </td>
+<td>
+                <p>

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <a class="link" href="iterate/compare_iterators.html"title="Compare two Iterator pointing into a Container Attribute forEquality"><code class="computeroutput"><spanclass="identifier">compare_iterators</code></a>

+                </p>
+                </td>
+<td>
+                <p>

+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.is_container.example"></a><h6>
+<a name="id944184"></a>

+ <a class="link"href="is_container.html#spirit.advanced.customize.is_container.example">Example</a>

+        </h6>
+<p>

+ For examples of how to use the customization point <codeclass="computeroutput">is_container</code>+ please see here: <a class="link"href="iterate/container_iterator.html#spirit.advanced.customize.iterate.container_iterator.example">embedded_container_example</a>,+ <a class="link"href="iterate/next_iterator.html#spirit.advanced.customize.iterate.next_iterator.example">use_as_container</a>,+ and <a class="link"href="iterate/deref_iterator.html#spirit.advanced.customize.iterate.deref_iterator.example">counter_example</a>.

+        </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/begin_container.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,471 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>Get the Iterator pointing to the Begin of a ContainerAttribute</title>+<link rel="stylesheet"href="../../../../../../../../doc/html/boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../iterate.html" title="Extract Attribute Values toGenerate Output from a Container (Karma)">+<link rel="prev" href="container_iterator.html" title="Determine the Typeof the Iterator of a Container (Karma)">+<link rel="next" href="end_container.html" title="Get the Iteratorpointing to the End of a Container Attribute">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="container_iterator.html"><imgsrc="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../iterate.html"><imgsrc="../../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../../index.html"><imgsrc="../../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="end_container.html"><imgsrc="../../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Get the Iterator pointing to the Begin of aContainer Attribute">

+<div class="titlepage"><div><div><h5 class="title">

+<a name="spirit.advanced.customize.iterate.begin_container"></a><aclass="link" href="begin_container.html" title="Get the Iterator pointingto the Begin of a Container Attribute">+ Get the Iterator pointing to the Begin of a ContainerAttribute</a>

+</h5></div></div></div>

+<aname="spirit.advanced.customize.iterate.begin_container.begin_container"></a><h6>

+<a name="id962296"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.begin_container">begin_container</a>

+          </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">begin_container</code>+ is a type used as an attribute customization point. It isinvoked by+ the Karma repetitivegenerators (such as <a class="link"href="../../../karma/reference/operator/list.html" title="Lists (a %b)">List+ (<code class="computeroutput"><spanclass="special">%</code>)</a>, <a class="link"href="../../../karma/reference/operator/kleene.html" title="Kleene Star(*a)">Kleene+ (unary <code class="computeroutput"><spanclass="special">*</code>)</a>, <a class="link"href="../../../karma/reference/operator/plus.html" title="Plus (+a)">Plus(unary <code class="computeroutput"><spanclass="special">+</code>)</a>, and <a class="link"href="../../../karma/reference/directive/repeat.html" title="RepetitionDirective (repeat[])">Repeat</a>)+ in order to get an iterator pointing to the first element ofthe container

+            holding the attributes to generate output from.
+          </p>

+<aname="spirit.advanced.customize.iterate.begin_container.module_headers"></a><h6>

+<a name="id962364"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.module_headers">Module

+            Headers</a>
+          </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/support<spanclass="special">/container<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link"href="../../../structure/include.html" title="Include">IncludeStructure</a>.

+          </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly byany user+ program as it is normally included by other Spirit headerfiles relying

+              on its content.
+            </p></td></tr>
+</table></div>

+<aname="spirit.advanced.customize.iterate.begin_container.namespace"></a><h6>

+<a name="id962862"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.namespace">Namespace</a>

+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                  <p>
+                    Name
+                  </p>
+                  </th></tr></thead>
+<tbody><tr><td>
+                  <p>

+                  </p>
+                  </td></tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.begin_container.synopsis"></a><h6>

+<a name="id962940"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.synopsis">Synopsis</a>

+          </h6>

+<span class="special">{</span>

+ static <spanclass="keyword">typename <spanclass="identifier">container_iterator<spanclass="special"><Container<spanclass="special">>::type+ call<spanclass="special">(Container<spanclass="special">& c<spanclass="special">);

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.iterate.begin_container.template_parameters"></a><h6>

+<a name="id963066"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.template_parameters">Template

+            parameters</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Parameter
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Description
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Default
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Container</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Container</code>+ for which the iterator pointing to the first elementhas to be

+                    returned
+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput"><spanclass="identifier">begin_container</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                  </p>
+                  </td>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.begin_container.notation"></a><h6>

+<a name="id963231"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.notation">Notation</a>

+          </h6>
+<div class="variablelist">
+<p class="title"><b></b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">C</code></dt>

+<dd><p>

+ A container type the begin iterator needs to be returnedfor.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">c</code></dt>

+<dd><p>

+ An instance of a container, <codeclass="computeroutput">C</code>.

+              </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.iterate.begin_container.expression_semantics"></a><h6>

+<a name="id963296"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.expression_semantics">Expression

+            Semantics</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Expression
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">begin_container<spanclass="special"><C<spanclass="special">>::call<spanclass="special">(c<spanclass="special">)</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Return the iterator usable to dereference the firstelement of+ the given container, <codeclass="computeroutput">c</code>.+ The type of the returned iterator is expected to bethe same+ as the type returned by the customization point <aclass="link" href="container_iterator.html" title="Determine the Type ofthe Iterator of a Container (Karma)"><code class="computeroutput"><spanclass="identifier">container_iterator</code></a>.

+                  </p>
+                  </td>
+</tr></tbody>
+</table></div>
+<p>

+ The returned instance conceptually needs to be equivalent to astandard+ forward iterator. But it does not have to expose thestandardized interface.+ If this customization point is implemented for a certaincontainer type,+ all related customization points need to be implemented aswell (see+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.related_attribute_customization_points">Related+ Attribute Customization Points</a> below). This encapsulatesthe specific+ iterator interface required for a given type. The minimalrequirements

+            for a type to be exposed as an iterator in this context are:
+          </p>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">

+ it needs to be comparable for equality (see <a class="link"href="compare_iterators.html" title="Compare two Iterator pointing into aContainer Attribute for Equality"><code class="computeroutput"><spanclass="identifier">compare_iterators</code></a>),

+            </li>
+<li class="listitem">

+ it needs to be incrementable (see <a class="link"href="next_iterator.html" title="Increment the Iterator pointing into aContainer Attribute"><code class="computeroutput"><spanclass="identifier">next_iterator</code></a>),

+            </li>
+<li class="listitem">

+ it needs to be dereferencible (see <a class="link"href="deref_iterator.html" title="Dereference the Iterator pointing into aContainer Attribute"><code class="computeroutput"><spanclass="identifier">deref_iterator</code></a>).

+            </li>
+</ul></div>

+<aname="spirit.advanced.customize.iterate.begin_container.predefined_specializations"></a><h6>

+<a name="id963462"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.predefined_specializations">Predefined

+            Specializations</a>
+          </h6>
+<p>

+ <a href="http://spirit.sourceforge.net";target="_top">Spirit</a> predefines+ specializations of this customization point for several types.The following+ table lists those types together with the types returned bythe embedded+ typedef <code class="computeroutput"><spanclass="identifier">type</code>:

+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Template Parameters
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Value
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">C</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="identifier">c.<spanclass="identifier">begin()</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">C const</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="identifier">c.<spanclass="identifier">begin()</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="special">&unused</code>.

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.begin_container.when_to_implement"></a><h6>

+<a name="id963649"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.when_to_implement">When

+            to implement</a>
+          </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">begin_container</code>+ needs to be implemented for a specific type whenever this typeis to+ be used as an attribute in place of a STL container. It isapplicable+ for generators (<spanclass="emphasis">Spirit.Karma) only. As a rule of+ thumb: it has to be implemented whenever a certain type is tobe passed+ as an attribute to a generator normally exposing a STLcontainer, <code class="computeroutput"><spanclass="identifier">C</code> and if the type does not expose the+ interface of a STL container (i.e. <codeclass="computeroutput">is_container<spanclass="special"><C<spanclass="special">>::type</code>+ would normally return <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">false_</code>).

+          </p>

+<aname="spirit.advanced.customize.iterate.begin_container.related_attribute_customization_points"></a><h6>

+<a name="id963720"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.related_attribute_customization_points">Related

+            Attribute Customization Points</a>
+          </h6>
+<p>

+ If this customization point is implemented, the followingother customization

+            points might need to be implemented as well.
+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Name
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    When to implement
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="../is_container.html"title="Determine if a Type Should be Treated as a Container (Qi andKarma)"><code class="computeroutput"><spanclass="identifier">is_container</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Needs to be implemented whenever a type is to be usedas a container+ attribute in <spanclass="emphasis">Karma.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="container_iterator.html"title="Determine the Type of the Iterator of a Container (Karma)"><codeclass="computeroutput"><spanclass="identifier">container_iterator</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Karma: <a class="link"href="../../../karma/reference/operator/list.html" title="Lists (a %b)">List+ (<code class="computeroutput"><spanclass="special">%</code>)</a>, <a class="link"href="../../../karma/reference/operator/kleene.html" title="Kleene Star(*a)">Kleene (unary+ <code class="computeroutput"><spanclass="special">*</code>)</a>, <a class="link"href="../../../karma/reference/operator/plus.html" title="Plus (+a)">Plus(unary <code class="computeroutput"><spanclass="special">+</code>)</a>, <a class="link"href="../../../karma/reference/directive/repeat.html" title="RepetitionDirective (repeat[])">Repeat</a>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="begin_container.html" title="Getthe Iterator pointing to the Begin of a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">begin_container</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="end_container.html" title="Getthe Iterator pointing to the End of a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">end_container</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="deref_iterator.html"title="Dereference the Iterator pointing into a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">deref_iterator</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="next_iterator.html"title="Increment the Iterator pointing into a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">next_iterator</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="compare_iterators.html"title="Compare two Iterator pointing into a Container Attribute forEquality"><code class="computeroutput"><spanclass="identifier">compare_iterators</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.begin_container.example"></a><h6>

+<a name="id964207"></a>

+ <a class="link"href="begin_container.html#spirit.advanced.customize.iterate.begin_container.example">Example</a>

+          </h6>
+<p>

+ For examples of how to use the customization point <codeclass="computeroutput"><spanclass="identifier">begin_container</code>+ please see here: <a class="link"href="container_iterator.html#spirit.advanced.customize.iterate.container_iterator.example">embedded_container_example</a>,+ <a class="link"href="next_iterator.html#spirit.advanced.customize.iterate.next_iterator.example">use_as_container</a>,+ and <a class="link"href="deref_iterator.html#spirit.advanced.customize.iterate.deref_iterator.example">counter_example</a>.

+          </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/compare_iterators.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,443 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>Compare two Iterator pointing into a Container Attribute forEquality</title>+<link rel="stylesheet"href="../../../../../../../../doc/html/boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../iterate.html" title="Extract Attribute Values toGenerate Output from a Container (Karma)">+<link rel="prev" href="deref_iterator.html" title="Dereference theIterator pointing into a Container Attribute">

+<link rel="next" href="../../../support.html" title="Supporting libraries">
+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="deref_iterator.html"><imgsrc="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../iterate.html"><imgsrc="../../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../../index.html"><imgsrc="../../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="../../../support.html"><imgsrc="../../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Compare two Iterator pointing into a ContainerAttribute for Equality">

+<div class="titlepage"><div><div><h5 class="title">

+<a name="spirit.advanced.customize.iterate.compare_iterators"></a><aclass="link" href="compare_iterators.html" title="Compare two Iteratorpointing into a Container Attribute for Equality">+ Compare two Iterator pointing into a Container Attribute forEquality</a>

+</h5></div></div></div>

+<aname="spirit.advanced.customize.iterate.compare_iterators.compare_iterators"></a><h6>

+<a name="id976061"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.compare_iterators">compare_iterators</a>

+          </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">compare_iterators</code>+ is a type used as an attribute customization point. It isinvoked by+ the Karma repetitivegenerators (such as <a class="link"href="../../../karma/reference/operator/list.html" title="Lists (a %b)">List+ (<code class="computeroutput"><spanclass="special">%</code>)</a>, <a class="link"href="../../../karma/reference/operator/kleene.html" title="Kleene Star(*a)">Kleene+ (unary <code class="computeroutput"><spanclass="special">*</code>)</a>, <a class="link"href="../../../karma/reference/operator/plus.html" title="Plus (+a)">Plus(unary <code class="computeroutput"><spanclass="special">+</code>)</a>, and <a class="link"href="../../../karma/reference/directive/repeat.html" title="RepetitionDirective (repeat[])">Repeat</a>)+ in order to compare the current iterator (returned either from<a class="link" href="begin_container.html" title="Get the Iteratorpointing to the Begin of a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">begin_container</code></a> or from <aclass="link" href="next_iterator.html" title="Increment the Iteratorpointing into a Container Attribute"><code class="computeroutput"><spanclass="identifier">next_iterator</code></a>) with the end+ iterator (returned from <a class="link"href="end_container.html" title="Get the Iterator pointing to the End of aContainer Attribute"><code class="computeroutput"><spanclass="identifier">end_container</code></a>) in order to find

+            the end of the element sequence to gerenate output for.
+          </p>

+<aname="spirit.advanced.customize.iterate.compare_iterators.module_headers"></a><h6>

+<a name="id976158"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.module_headers">Module

+            Headers</a>
+          </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/support<spanclass="special">/container<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link"href="../../../structure/include.html" title="Include">IncludeStructure</a>.

+          </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly byany user+ program as it is normally included by other Spirit headerfiles relying

+              on its content.
+            </p></td></tr>
+</table></div>

+<aname="spirit.advanced.customize.iterate.compare_iterators.namespace"></a><h6>

+<a name="id976246"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.namespace">Namespace</a>

+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                  <p>
+                    Name
+                  </p>
+                  </th></tr></thead>
+<tbody><tr><td>
+                  <p>

+                  </p>
+                  </td></tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.compare_iterators.synopsis"></a><h6>

+<a name="id976324"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.synopsis">Synopsis</a>

+          </h6>

+<span class="special">{</span>

+ static boolcall(<spanclass="identifier">Iterator const<spanclass="special">& it1<spanclass="special">, Iterator <spanclass="keyword">const& <spanclass="identifier">it2);

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.iterate.compare_iterators.template_parameters"></a><h6>

+<a name="id976457"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.template_parameters">Template

+            parameters</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Parameter
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Description
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Default
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Iterator</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Iterator</code>+ of the iterator to dereference. This is the same asthe type+ returned by the customization point <a class="link"href="container_iterator.html" title="Determine the Type of the Iterator ofa Container (Karma)"><code class="computeroutput"><spanclass="identifier">container_iterator</code></a>.

+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput"><spanclass="identifier">compare_iterators</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                  </p>
+                  </td>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.compare_iterators.notation"></a><h6>

+<a name="id976632"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.notation">Notation</a>

+          </h6>
+<div class="variablelist">
+<p class="title"><b></b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">Iterator</code></dt>

+<dd><p>
+                An iterator type.
+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">it1</code>,+ <code class="computeroutput"><spanclass="identifier">it2</code></dt>

+<dd><p>

+ Instance of iterators of type, <codeclass="computeroutput">Iterator</code>.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">C</code></dt>

+<dd><p>

+ A container type a iterator type, <codeclass="computeroutput">Iterator</code>

+                belongs to.
+              </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.iterate.compare_iterators.expression_semantics"></a><h6>

+<a name="id976729"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.expression_semantics">Expression

+            Semantics</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Expression
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">compare_iterators<spanclass="special"><Iterator<spanclass="special">>::call<spanclass="special">(it1<spanclass="special">, it2<spanclass="special">)</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns whether the iterators <codeclass="computeroutput">it1</code>+ <code class="computeroutput"><spanclass="identifier">it2</code> are to be

+                    treated as beeing equal.
+                  </p>
+                  </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.compare_iterators.predefined_specializations"></a><h6>

+<a name="id976848"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.predefined_specializations">Predefined

+            Specializations</a>
+          </h6>
+<p>

+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Template Parameters
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Value
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Iterator</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The function <code class="computeroutput"><spanclass="identifier">call()</code>returns it1 == it2.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code><code class="computeroutput">+ const<spanclass="special">*</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The function <code class="computeroutput"><spanclass="identifier">call()</code> alwaysreturns false.

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.compare_iterators.when_to_implement"></a><h6>

+<a name="id976992"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.when_to_implement">When

+            to implement</a>
+          </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">compare_iterators</code>+ needs to be implemented for a specific iterator type wheneverthe container+ this iterator belongs to is to be used as an attribute inplace of a+ STL container. It is applicable for generators (<spanclass="emphasis">Spirit.Karma)+ only. As a rule of thumb: it has to be implemented whenever acertain+ iterator type belongs to a container which is to be passed asan attribute+ to a generator normally exposing a STL container, <codeclass="computeroutput">C</code>+ and if the container type does not expose the interface of aSTL container+ (i.e. <code class="computeroutput"><spanclass="identifier">is_container<spanclass="special"><C<spanclass="special">>::type</code>would normally return <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">false_</code>).

+          </p>

+<aname="spirit.advanced.customize.iterate.compare_iterators.related_attribute_customization_points"></a><h6>

+<a name="id977063"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.related_attribute_customization_points">Related

+            Attribute Customization Points</a>
+          </h6>
+<p>

+ If this customization point is implemented, the followingother customization

+            points might need to be implemented as well.
+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Name
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    When to implement
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Needs to be implemented whenever a type is to be usedas a container+ attribute in <spanclass="emphasis">Karma.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="end_container.html" title="Getthe Iterator pointing to the End of a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">end_container</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="deref_iterator.html"title="Dereference the Iterator pointing into a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">deref_iterator</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="next_iterator.html"title="Increment the Iterator pointing into a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">next_iterator</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.compare_iterators.example"></a><h6>

+<a name="id979189"></a>

+ <a class="link"href="compare_iterators.html#spirit.advanced.customize.iterate.compare_iterators.example">Example</a>

+          </h6>
+<p>

+ For an example of how to use the customization point <codeclass="computeroutput"><spanclass="identifier">compare_iterators</code>+ please see here: <a class="link"href="next_iterator.html#spirit.advanced.customize.iterate.next_iterator.example">use_as_container</a>.

+          </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/container_iterator.htmlThu Dec 3 23:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/deref_iterator.htmlThu Dec 3 23:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/end_container.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,451 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>Get the Iterator pointing to the End of a ContainerAttribute</title>+<link rel="stylesheet"href="../../../../../../../../doc/html/boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../iterate.html" title="Extract Attribute Values toGenerate Output from a Container (Karma)">+<link rel="prev" href="begin_container.html" title="Get the Iteratorpointing to the Begin of a Container Attribute">+<link rel="next" href="next_iterator.html" title="Increment the Iteratorpointing into a Container Attribute">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="begin_container.html"><imgsrc="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../iterate.html"><imgsrc="../../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../../index.html"><imgsrc="../../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="next_iterator.html"><imgsrc="../../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Get the Iterator pointing to the End of aContainer Attribute">

+<div class="titlepage"><div><div><h5 class="title">

+<a name="spirit.advanced.customize.iterate.end_container"></a><aclass="link" href="end_container.html" title="Get the Iterator pointing tothe End of a Container Attribute">

+          Get the Iterator pointing to the End of a Container Attribute</a>
+</h5></div></div></div>

+<aname="spirit.advanced.customize.iterate.end_container.end_container"></a><h6>

+<a name="id964266"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.end_container">end_container</a>

+          </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">end_container</code>+ is a type used as an attribute customization point. It isinvoked by+ the Karma repetitivegenerators (such as <a class="link"href="../../../karma/reference/operator/list.html" title="Lists (a %b)">List+ (<code class="computeroutput"><spanclass="special">%</code>)</a>, <a class="link"href="../../../karma/reference/operator/kleene.html" title="Kleene Star(*a)">Kleene+ (unary <code class="computeroutput"><spanclass="special">*</code>)</a>, <a class="link"href="../../../karma/reference/operator/plus.html" title="Plus (+a)">Plus(unary <code class="computeroutput"><spanclass="special">+</code>)</a>, and <a class="link"href="../../../karma/reference/directive/repeat.html" title="RepetitionDirective (repeat[])">Repeat</a>)+ in order to get an iterator pointing to the end of thecontainer holding

+            the attributes to generate output from.
+          </p>

+<aname="spirit.advanced.customize.iterate.end_container.module_headers"></a><h6>

+<a name="id964339"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.module_headers">Module

+            Headers</a>
+          </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/support<spanclass="special">/container<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link"href="../../../structure/include.html" title="Include">IncludeStructure</a>.

+          </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly byany user+ program as it is normally included by other Spirit headerfiles relying

+              on its content.
+            </p></td></tr>
+</table></div>

+<aname="spirit.advanced.customize.iterate.end_container.namespace"></a><h6>

+<a name="id964429"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.namespace">Namespace</a>

+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                  <p>
+                    Name
+                  </p>
+                  </th></tr></thead>
+<tbody><tr><td>
+                  <p>

+                  </p>
+                  </td></tr></tbody>
+</table></div>
+<a name="spirit.advanced.customize.iterate.end_container.synopsis"></a><h6>
+<a name="id964507"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.synopsis">Synopsis</a>

+          </h6>

+<span class="special">{</span>

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.iterate.end_container.template_parameters"></a><h6>

+<a name="id964633"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.template_parameters">Template

+            parameters</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Parameter
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Description
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Default
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Container</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Container</code>+ for which the iterator pointing to the first elementhas to be

+                    returned
+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput">end_container</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                  </p>
+                  </td>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.iterate.end_container.notation"></a><h6>
+<a name="id964799"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.notation">Notation</a>

+          </h6>
+<div class="variablelist">
+<p class="title"><b></b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">C</code></dt>

+<dd><p>
+                A container type the end iterator needs to be returned for.
+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">c</code></dt>

+<dd><p>

+ An instance of a container, <codeclass="computeroutput">C</code>.

+              </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.iterate.end_container.expression_semantics"></a><h6>

+<a name="id964863"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.expression_semantics">Expression

+            Semantics</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Expression
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">end_container<spanclass="special"><C<spanclass="special">>::call<spanclass="special">(c<spanclass="special">)</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Return the iterator usable to compare a differentiterator with+ in order to detect whether the other iterator reachedthe end+ of the given container, <codeclass="computeroutput">c</code>.+ The type of the returned iterator is expected to bethe same+ as the type returned by the customization point <aclass="link" href="container_iterator.html" title="Determine the Type ofthe Iterator of a Container (Karma)"><code class="computeroutput"><spanclass="identifier">container_iterator</code></a>.

+                  </p>
+                  </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.end_container.predefined_specializations"></a><h6>

+<a name="id964976"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.predefined_specializations">Predefined

+            Specializations</a>
+          </h6>
+<p>

+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Template Parameters
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Value
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">C</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="identifier">c.<spanclass="identifier">end()</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">C const</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="identifier">c.<spanclass="identifier">end()</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="special">&unused</code>.

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.iterate.end_container.when_to_implement"></a><h6>

+<a name="id965716"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.when_to_implement">When

+            to implement</a>
+          </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">end_container</code>+ needs to be implemented for a specific type whenever this typeis to+ be used as an attribute in place of a STL container. It isapplicable+ for generators (<spanclass="emphasis">Spirit.Karma) only. As a rule of+ thumb: it has to be implemented whenever a certain type is tobe passed+ as an attribute to a generator normally exposing a STLcontainer, <code class="computeroutput"><spanclass="identifier">C</code> and if the type does not expose the+ interface of a STL container (i.e. <codeclass="computeroutput">is_container<spanclass="special"><C<spanclass="special">>::type</code>+ would normally return <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">false_</code>).

+          </p>

+<aname="spirit.advanced.customize.iterate.end_container.related_attribute_customization_points"></a><h6>

+<a name="id965787"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.related_attribute_customization_points">Related

+            Attribute Customization Points</a>
+          </h6>
+<p>

+ If this customization point is implemented, the followingother customization

+            points might need to be implemented as well.
+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Name
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    When to implement
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Needs to be implemented whenever a type is to be usedas a container+ attribute in <spanclass="emphasis">Karma.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="end_container.html" title="Getthe Iterator pointing to the End of a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">end_container</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="deref_iterator.html"title="Dereference the Iterator pointing into a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">deref_iterator</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="next_iterator.html"title="Increment the Iterator pointing into a Container Attribute"><codeclass="computeroutput"><spanclass="identifier">next_iterator</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.iterate.end_container.example"></a><h6>
+<a name="id966272"></a>

+ <a class="link"href="end_container.html#spirit.advanced.customize.iterate.end_container.example">Example</a>

+          </h6>
+<p>

+ For examples of how to use the customization point <codeclass="computeroutput">end_container</code>+ please see here: <a class="link"href="container_iterator.html#spirit.advanced.customize.iterate.container_iterator.example">embedded_container_example</a>,+ <a class="link"href="next_iterator.html#spirit.advanced.customize.iterate.next_iterator.example">use_as_container</a>,+ and <a class="link"href="deref_iterator.html#spirit.advanced.customize.iterate.deref_iterator.example">counter_example</a>.

+          </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate/next_iterator.htmlThu Dec 3 23:11:44 2009

Binary file, no diff available.
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/advanced/customize/iterate.html ThuDec 3 23:11:44 2009

@@ -0,0 +1,59 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>Extract Attribute Values to Generate Output from a Container(Karma)</title>+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../customize.html" title="Customization of Spirit'sAttribute Handling">+<link rel="prev" href="extract_from.html" title="Extract an AttributeValue to Generate Output (Karma)">+<link rel="next" href="iterate/container_iterator.html" title="Determinethe Type of the Iterator of a Container (Karma)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="extract_from.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../customize.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="iterate/container_iterator.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Extract Attribute Values to Generate Outputfrom a Container (Karma)">

+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.advanced.customize.iterate"></a><a class="link"href="iterate.html" title="Extract Attribute Values to Generate Output froma Container (Karma)"> Extract Attribute

+        Values to Generate Output from a Container (Karma)</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section"><a href="iterate/container_iterator.html">

+ Determine the Type of the Iterator of a Container(Karma)</a></dt>

+<dt><span class="section"><a href="iterate/begin_container.html">

+ Get the Iterator pointing to the Begin of a ContainerAttribute</a></dt>

+<dt><span class="section"><a href="iterate/end_container.html">

+ Get the Iterator pointing to the End of a ContainerAttribute</a></dt>

+<dt><span class="section"><a href="iterate/next_iterator.html">

+ Increment the Iterator pointing into a ContainerAttribute</a></dt>

+<dt><span class="section"><a href="iterate/deref_iterator.html">

+ Dereference the Iterator pointing into a ContainerAttribute</a></dt>

+<dt><span class="section"><a href="iterate/compare_iterators.html">

+ Compare two Iterator pointing into a Container Attribute forEquality</a></dt>

+</dl></div>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/store_value/container_value.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,403 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Determine the Type to be Stored in a Container (Qi)</title>

+<link rel="stylesheet"href="../../../../../../../../doc/html/boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../store_value.html" title="Store Parsed AttributeValues into a Container (Qi)">+<link rel="prev" href="../store_value.html" title="Store Parsed AttributeValues into a Container (Qi)">+<link rel="next" href="push_back.html" title="Store a Parsed AttributeValue into a Container (Qi)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="../store_value.html"><imgsrc="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../store_value.html"><imgsrc="../../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../../index.html"><imgsrc="../../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="push_back.html"><imgsrc="../../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Determine the Type to be Stored in a Container(Qi)">

+<div class="titlepage"><div><div><h5 class="title">

+<a name="spirit.advanced.customize.store_value.container_value"></a><aclass="link" href="container_value.html" title="Determine the Type to beStored in a Container (Qi)">

+          Determine the Type to be Stored in a Container (Qi)</a>
+</h5></div></div></div>

+<aname="spirit.advanced.customize.store_value.container_value.container_value"></a><h6>

+<a name="id952641"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.container_value">container_value</a>

+          </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">container_value</code>+ is a template meta function used as an attribute customizationpoint.+ It is invoked by the Qirepetitive parsers (<a class="link"href="../../../qi/reference/operator/kleene.html" title="Kleene(*a)">Kleene</a>, <a class="link"href="../../../qi/reference/operator/plus.html" title="Plus (+a)">Plus</a>,+ <a class="link"href="../../../qi/reference/operator/list.html" title="List (a %b)">List</a>, and <a class="link"href="../../../qi/reference/directive/repeat.html" title="Repetition(repeat[])">Repeat</a>) to determine

+            the type to store in a container.
+          </p>

+<aname="spirit.advanced.customize.store_value.container_value.module_headers"></a><h6>

+<a name="id952687"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.module_headers">Module

+            Headers</a>
+          </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/support<spanclass="special">/container<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link"href="../../../structure/include.html" title="Include">IncludeStructure</a>.

+          </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly byany user+ program as it is normally included by other Spirit headerfiles relying

+              on its content.
+            </p></td></tr>
+</table></div>

+<aname="spirit.advanced.customize.store_value.container_value.namespace"></a><h6>

+<a name="id952775"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.namespace">Namespace</a>

+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                  <p>
+                    Name
+                  </p>
+                  </th></tr></thead>
+<tbody><tr><td>
+                  <p>

+                  </p>
+                  </td></tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.store_value.container_value.synopsis"></a><h6>

+<a name="id952853"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.synopsis">Synopsis</a>

+          </h6>

+<span class="special">{</span>

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.store_value.container_value.template_parameters"></a><h6>

+<a name="id952951"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.template_parameters">Template

+            parameters</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Parameter
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Description
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Default
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Container</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Container</code>+ needs to be tested whether it has to be treated as acontainer

+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput"><spanclass="identifier">container_value</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                  </p>
+                  </td>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.store_value.container_value.notation"></a><h6>

+<a name="id953117"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.notation">Notation</a>

+          </h6>
+<div class="variablelist">
+<p class="title"><b></b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">C</code></dt>

+<dd><p>

+ A type to be tested whether it needs to be treated as acontainer.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">T1</code>,+ <code class="computeroutput"><spanclass="identifier">T2</code>, ...</dt>

+<dd><p>
+                Arbitrary types
+              </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.store_value.container_value.expression_semantics"></a><h6>

+<a name="id953183"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.expression_semantics">Expression

+            Semantics</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Expression
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">container_value<spanclass="special"><C<spanclass="special">>::type</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Metafunction that evaluates to the type to be storedin a given+ container type, <code class="computeroutput"><spanclass="identifier">C</code>.

+                  </p>
+                  </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.store_value.container_value.predefined_specializations"></a><h6>

+<a name="id953275"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.predefined_specializations">Predefined

+            Specializations</a>
+          </h6>
+<p>

+            semantics:
+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Template Parameters
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Value
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">C</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The non-const <code class="computeroutput"><spanclass="identifier">value_type</code>+ of the given container type, <codeclass="computeroutput">C</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="identifier">container_value<spanclass="special"><C<spanclass="special">>::type</code>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                    <span class="special">...&gt;</span></code>
+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="identifier">container_value<spanclass="special"><TN<spanclass="special">>::value</code>+ for the first <code class="computeroutput"><spanclass="identifier">TN</code>+ (out of <code class="computeroutput"><spanclass="identifier">T1</code>,+ <code class="computeroutput"><spanclass="identifier">T2</code>, ...) for+ which <code class="computeroutput"><spanclass="identifier">is_container<spanclass="special"><TN<spanclass="special">>::type</code>+ evaluates to <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">true_</code>.+ Otherwise it will return <codeclass="computeroutput">unused_type</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Returns <code class="computeroutput"><spanclass="identifier">unused_type</code>.

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.store_value.container_value.when_to_implement"></a><h6>

+<a name="id953607"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.when_to_implement">When

+            to implement</a>
+          </h6>
+<p>

+            components have an attribute propagation rule in the form:
+          </p>

+</pre>
+<p>

+ where <code class="computeroutput"><spanclass="identifier">Op(<spanclass="identifier">a)</code>+ stands for any meaningful operation on the component <codeclass="computeroutput">a</code>.

+          </p>

+<aname="spirit.advanced.customize.store_value.container_value.related_attribute_customization_points"></a><h6>

+<a name="id953723"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.related_attribute_customization_points">Related

+            Attribute Customization Points</a>
+          </h6>
+<p>

+ If this customization point is implemented, the followingother customization

+            points might need to be implemented as well.
+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Name
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    When to implement
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="push_back.html" title="Store aParsed Attribute Value into a Container (Qi)"><codeclass="computeroutput"><spanclass="identifier">push_back_container</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Qi: <a class="link"href="../../../qi/reference/operator/list.html" title="List (a %b)">List</a>,+ <a class="link"href="../../../qi/reference/operator/kleene.html" title="Kleene(*a)">Kleene</a>,+ <a class="link"href="../../../qi/reference/operator/plus.html" title="Plus (+a)">Plus</a>,+ <a class="link"href="../../../qi/reference/directive/repeat.html" title="Repetition(repeat[])">Repeat</a>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="../clear_value.html"title="Re-Initialize an Attribute Value before Parsing (Qi)"><codeclass="computeroutput"><spanclass="identifier">clear_value</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.store_value.container_value.example"></a><h6>

+<a name="id953868"></a>

+ <a class="link"href="container_value.html#spirit.advanced.customize.store_value.container_value.example">Example</a>

+          </h6>
+<p>
+            TBD
+          </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++/trunk/libs/spirit/doc/html/spirit/advanced/customize/store_value/push_back.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,450 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Store a Parsed Attribute Value into a Container (Qi)</title>

+<link rel="stylesheet"href="../../../../../../../../doc/html/boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../store_value.html" title="Store Parsed AttributeValues into a Container (Qi)">+<link rel="prev" href="container_value.html" title="Determine the Type tobe Stored in a Container (Qi)">+<link rel="next" href="../clear_value.html" title="Re-Initialize anAttribute Value before Parsing (Qi)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="container_value.html"><imgsrc="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../store_value.html"><imgsrc="../../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../../index.html"><imgsrc="../../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="../clear_value.html"><imgsrc="../../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Store a Parsed Attribute Value into aContainer (Qi)">

+<div class="titlepage"><div><div><h5 class="title">

+<a name="spirit.advanced.customize.store_value.push_back"></a><aclass="link" href="push_back.html" title="Store a Parsed Attribute Valueinto a Container (Qi)">

+          Store a Parsed Attribute Value into a Container (Qi)</a>
+</h5></div></div></div>

+<aname="spirit.advanced.customize.store_value.push_back.push_back_container"></a><h6>

+<a name="id953899"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.push_back_container">push_back_container</a>

+          </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">push_back_container</code>+ is a type used as an attribute customization point. It isinvoked by+ the Qi repetitiveparsers (<a class="link" href="../../../qi/reference/operator/kleene.html"title="Kleene (*a)">Kleene</a>,+ <a class="link"href="../../../qi/reference/operator/plus.html" title="Plus (+a)">Plus</a>,<a class="link" href="../../../qi/reference/operator/list.html" title="List(a % b)">List</a>, and <a class="link"href="../../../qi/reference/directive/repeat.html" title="Repetition(repeat[])">Repeat</a>)

+            to store a parsed attribute value into a container.
+          </p>

+<aname="spirit.advanced.customize.store_value.push_back.module_headers"></a><h6>

+<a name="id953949"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.module_headers">Module

+            Headers</a>
+          </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/support<spanclass="special">/container<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link"href="../../../structure/include.html" title="Include">IncludeStructure</a>.

+          </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly byany user+ program as it is normally included by other Spirit headerfiles relying

+              on its content.
+            </p></td></tr>
+</table></div>

+<aname="spirit.advanced.customize.store_value.push_back.namespace"></a><h6>

+<a name="id954244"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.namespace">Namespace</a>

+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                  <p>
+                    Name
+                  </p>
+                  </th></tr></thead>
+<tbody><tr><td>
+                  <p>

+                  </p>
+                  </td></tr></tbody>
+</table></div>
+<a name="spirit.advanced.customize.store_value.push_back.synopsis"></a><h6>
+<a name="id954322"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.synopsis">Synopsis</a>

+          </h6>

+<span class="special">{</span>

+ static voidcall(<spanclass="identifier">Container& <spanclass="identifier">c, <spanclass="identifier">Attrib const<spanclass="special">& val<spanclass="special">);

+<span class="special">};</span>
+</pre>

+<aname="spirit.advanced.customize.store_value.push_back.template_parameters"></a><h6>

+<a name="id954464"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.template_parameters">Template

+            parameters</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Parameter
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Description
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Default
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Container</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Container</code>+ needs to be tested whether it has to be treated as acontainer

+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ The type, <code class="computeroutput"><spanclass="identifier">Attrib</code>+ is the one returned from the customization point <aclass="link" href="container_value.html" title="Determine the Type to beStored in a Container (Qi)"><code class="computeroutput"><spanclass="identifier">container_value</code></a> and+ represents the attribute value to be stored in thecontainer+ of type <code class="computeroutput"><spanclass="identifier">Container</code>.

+                  </p>
+                  </td>
+<td>
+                  <p>
+                    none
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput"><spanclass="identifier">push_back_container</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                  </p>
+                  </td>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.store_value.push_back.notation"></a><h6>
+<a name="id954683"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.notation">Notation</a>

+          </h6>
+<div class="variablelist">
+<p class="title"><b></b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">C</code></dt>

+<dd><p>

+ A type to be used as a container to store attribute valuesin.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">c</code></dt>

+<dd>
+<p>

+ A container instance of type <codeclass="computeroutput">C</code>.

+              </p>
+<p>

+ [<code class="computeroutput"><spanclass="identifier">Attrib</code>

+              </p>
+<p>

+ A type to be used as a container to store attribute valuesin.

+              </p>
+</dd>

+<dt><code class="computeroutput"><spanclass="identifier">attr</code></dt>

+<dd><p>

+ A attribute instance of type <codeclass="computeroutput">Attrib</code>.

+              </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">T1</code>,+ <code class="computeroutput"><spanclass="identifier">T2</code>, ...</dt>

+<dd><p>
+                Arbitrary types
+              </p></dd>
+</dl>
+</div>

+<aname="spirit.advanced.customize.store_value.push_back.expression_semantics"></a><h6>

+<a name="id954821"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.expression_semantics">Expression

+            Semantics</a>
+          </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Expression
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Semantics
+                  </p>
+                  </th>
+</tr></thead>
+<tbody><tr>
+<td>
+                  <p>
+
+</p>

+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";class="table-programlisting"><spanclass="identifier">push_back_container<spanclass="special"><C<spanclass="special">, Attrib<spanclass="special">>::call<spanclass="special">(c<spanclass="special">, attr<spanclass="special">)</pre>

+<p>
+                  </p>
+                  </td>
+<td>
+                  <p>

+ Static function that is invoked whenever an attributevalue,+ <code class="computeroutput"><spanclass="identifier">attr</code> needs to+ be stored into the container instance <codeclass="computeroutput">c</code>.

+                  </p>
+                  </td>
+</tr></tbody>
+</table></div>

+<aname="spirit.advanced.customize.store_value.push_back.predefined_specializations"></a><h6>

+<a name="id954948"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.predefined_specializations">Predefined

+            Specializations</a>
+          </h6>
+<p>

+            semantics:
+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Template Parameters
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    Value
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">C</code>, <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ Store the provided attribute instance <codeclass="computeroutput">attr</code>+ into the given container <codeclass="computeroutput">c</code>+ using the function call <codeclass="computeroutput">c<spanclass="special">.insert<spanclass="special">(c<spanclass="special">.end<spanclass="special">(), attr<spanclass="special">)</code>.

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">optional<<spanclass="identifier">C></code>,+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ If the provided instance of <codeclass="computeroutput">boost<spanclass="special">::optional<spanclass="special"><></code> is not initialized, invoke+ the appropriate initialization and afterwards applythe customization+ point <code class="computeroutput"><spanclass="identifier">push_back_container<spanclass="special"><C<spanclass="special">, Attrib<spanclass="special">></code>, treating the instance held+ by the optional (of type <codeclass="computeroutput">C</code>)

+                    as the container to store the attribute in.
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+                  </p>
+                  </td>
+<td>
+                  <p>

+ If the instance of the variant currently holds a valuewith a+ type, <code class="computeroutput"><spanclass="identifier">TN</code>, for+ which <code class="computeroutput"><spanclass="identifier">is_container<spanclass="special"><TN<spanclass="special">>::type</code>+ evaluates to <code class="computeroutput"><spanclass="identifier">mpl::<spanclass="identifier">true_</code>,+ this customization point specialization will apply<code class="computeroutput"><spanclass="identifier">push_back_container<spanclass="special"><TN<spanclass="special">,+ Attrib<spanclass="special">></code>,+ treating the instance held by the variant (of type<code class="computeroutput">TN</code>) asthe container to store

+                    the attribute in. Otherwise it will raise an assertion.
+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>

+                  </p>
+                  </td>
+<td>
+                  <p>
+                    Do nothing.
+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.store_value.push_back.when_to_implement"></a><h6>

+<a name="id955356"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.when_to_implement">When

+            to Implement</a>
+          </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">push_back_container</code>+ needs to be implemented for a specific type whenever this typeis to+ be used as an attribute in place of a STL container. It isapplicable+ for parsers (Spirit.Qi)only. As a rule of thumb:+ it has to be implemented whenever a certain type is to bepassed as an+ attribute to a parser normally exposing a STL container and ifthe type+ does not expose the interface of a STL container (i.e. nofunction being+ equivalent to <code class="computeroutput"><spanclass="identifier">c.<spanclass="identifier">insert(<spanclass="identifier">c.<spanclass="identifier">end(), <spanclass="identifier">attr)</code>.+ These components have an attribute propagation rule in theform:

+          </p>

+</pre>
+<p>

+ where <code class="computeroutput"><spanclass="identifier">Op(<spanclass="identifier">a)</code>+ stands for any meaningful operation on the component <codeclass="computeroutput">a</code>.

+          </p>

+<aname="spirit.advanced.customize.store_value.push_back.related_attribute_customization_points"></a><h6>

+<a name="id955506"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.related_attribute_customization_points">Related

+            Attribute Customization Points</a>
+          </h6>
+<p>

+ If this customization point is implemented, the followingother customization

+            points might need to be implemented as well.
+          </p>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                  <p>
+                    Name
+                  </p>
+                  </th>
+<th>
+                  <p>
+                    When to implement
+                  </p>
+                  </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="container_value.html"title="Determine the Type to be Stored in a Container (Qi)"><codeclass="computeroutput"><spanclass="identifier">container_value</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+<tr>
+<td>
+                  <p>

+ <a class="link" href="../clear_value.html"title="Re-Initialize an Attribute Value before Parsing (Qi)"><codeclass="computeroutput"><spanclass="identifier">clear_value</code></a>

+                  </p>
+                  </td>
+<td>
+                  <p>

+                  </p>
+                  </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.store_value.push_back.example"></a><h6>
+<a name="id955649"></a>

+ <a class="link"href="push_back.html#spirit.advanced.customize.store_value.push_back.example">Example</a>

+          </h6>
+<p>
+            TBD
+          </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/advanced/customize/store_value.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,59 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Store Parsed Attribute Values into a Container (Qi)</title>

+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../customize.html" title="Customization of Spirit'sAttribute Handling">+<link rel="prev" href="assign_to/assign_to_attribute_from_value.html"title="Store an Attribute Value after a Parser Produced a Value (Qi)">+<link rel="next" href="store_value/container_value.html" title="Determinethe Type to be Stored in a Container (Qi)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="assign_to/assign_to_attribute_from_value.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../customize.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="store_value/container_value.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Store Parsed Attribute Values into a Container(Qi)">

+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.advanced.customize.store_value"></a><a class="link"href="store_value.html" title="Store Parsed Attribute Values into aContainer (Qi)"> Store Parsed

+        Attribute Values into a Container (Qi)</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section"><a href="store_value/container_value.html">

+ Determine the Type to be Stored in a Container(Qi)</a></dt>

+<dt><span class="section"><a href="store_value/push_back.html">

+ Store a Parsed Attribute Value into a Container(Qi)</a></dt>

+</dl></div>
+<p>

+ In order to customize Spirit to accept a given data type as acontainer+ for elements parsed by any of the repetitive parsers (<aclass="link" href="../../qi/reference/operator/kleene.html" title="Kleene(*a)">Kleene</a>,+ <a class="link" href="../../qi/reference/operator/plus.html"title="Plus (+a)">Plus</a>, <a class="link"href="../../qi/reference/operator/list.html" title="List (a % b)">List</a>,+ and <a class="link"href="../../qi/reference/directive/repeat.html" title="Repetition(repeat[])">Repeat</a>)+ two attribute customization points have to be specialized: <aclass="link" href="store_value/container_value.html" title="Determine theType to be Stored in a Container (Qi)"><code class="computeroutput"><spanclass="identifier">container_value</code></a> and <a class="link"href="store_value/push_back.html" title="Store a Parsed Attribute Valueinto a Container (Qi)"><code class="computeroutput"><spanclass="identifier">push_back_container</code></a>. This section

+          describes both.
+        </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/advanced/customize/transform.htmlThu Dec 3 23:11:44 2009

@@ -0,0 +1,493 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Transform an Attribute to a Different Type (Qi and Karma)</title>

+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">

+<link rel="up" href="../customize.html" title="Customization of Spirit'sAttribute Handling">+<link rel="prev" href="is_container.html" title="Determine if a TypeShould be Treated as a Container (Qi and Karma)">+<link rel="next" href="assign_to.html" title="Store a Parsed AttributeValue (Qi)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../../index.html">Home</a></td>

+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="is_container.html"><imgsrc="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../customize.html"><imgsrc="../../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../../index.html"><imgsrc="../../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="assign_to.html"><imgsrc="../../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>

+<div class="section" title="Transform an Attribute to a Different Type (Qiand Karma)">

+<div class="titlepage"><div><div><h4 class="title">

+<a name="spirit.advanced.customize.transform"></a><a class="link"href="transform.html" title="Transform an Attribute to a Different Type (Qiand Karma)"> Transform an

+        Attribute to a Different Type (Qi and Karma)</a>
+</h4></div></div></div>
+<a name="spirit.advanced.customize.transform.transform_attribute"></a><h6>
+<a name="id944240"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.transform_attribute">transform_attribute</a>

+        </h6>
+<p>

+ The template <code class="computeroutput"><spanclass="identifier">transform_attribute</code>+ is a type used as an attribute customization point. It isinvoked by Qi+ <code class="computeroutput"><spanclass="identifier">rule</code> and <codeclass="computeroutput">attr_cast</code>,and Karma+ <code class="computeroutput"><spanclass="identifier">rule</code> and <a class="link"href="../../karma/reference/auxiliary/attr_cast.html" title="AttributeTransformation Pseudo Generator (attr_cast)"><codeclass="computeroutput"><spanclass="identifier">attr_cast</code></a>. It is used to automatically+ transform the user provided attribute to the attribute typeexpected by+ the right hand side component (for <codeclass="computeroutput">rule</code>)+ or the embedded component (for <codeclass="computeroutput">attr_cast</code>).

+        </p>
+<a name="spirit.advanced.customize.transform.module_headers"></a><h6>
+<a name="id944316"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.module_headers">Module

+          Headers</a>
+        </h6>

+<pre class="programlisting">#include<boost<spanclass="special">/spirit<spanclass="special">/home<spanclass="special">/support<spanclass="special">/attributes<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>

+ Also, see <a class="link" href="../../structure/include.html"title="Include">Include Structure</a>.

+        </p>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"src="../../../images/note.png"></td>

+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ This header file does not need to be included directly by anyuser program+ as it is normally included by other Spirit header filesrelying on its

+            content.
+          </p></td></tr>
+</table></div>
+<a name="spirit.advanced.customize.transform.namespace"></a><h6>
+<a name="id944402"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.namespace">Namespace</a>

+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+                <p>
+                  Name
+                </p>
+                </th></tr></thead>
+<tbody><tr><td>
+                <p>

+                </p>
+                </td></tr></tbody>
+</table></div>
+<a name="spirit.advanced.customize.transform.synopsis"></a><h6>
+<a name="id944475"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.synopsis">Synopsis</a>

+        </h6>

+<span class="special">{</span>

+ typedef <spanclass="special"><unspecified<spanclass="special">> type<spanclass="special">;+ static <spanclass="identifier">type pre<spanclass="special">(Exposed<spanclass="special">& val<spanclass="special">);+ static voidpost(<spanclass="identifier">Exposed& <spanclass="identifier">val, <spanclass="identifier">type attr<spanclass="special">); // Qi only

+</span><span class="special">};</span>
+</pre>
+<a name="spirit.advanced.customize.transform.template_parameters"></a><h6>
+<a name="id944668"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.template_parameters">Template

+          parameters</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Parameter
+                </p>
+                </th>
+<th>
+                <p>
+                  Description
+                </p>
+                </th>
+<th>
+                <p>
+                  Default
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Exposed</code>

+                </p>
+                </td>
+<td>
+                <p>

+ The attribute type supplied to the component which needsto be

+                  transformed.
+                </p>
+                </td>
+<td>
+                <p>
+                  none
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Transformed</code>

+                </p>
+                </td>
+<td>
+                <p>

+ The attribute type expected by the component to beprovided as

+                  the result of the transformation.
+                </p>
+                </td>
+<td>
+                <p>
+                  none
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Enable</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Helper template parameter usable to selectively enableor disable+ certain specializations of <codeclass="computeroutput"><spanclass="identifier">transform_attribute</code>+ utilizing SFINAE (i.e. <codeclass="computeroutput">boost<spanclass="special">::enable_if</code>+ or <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">disable_if</code>).

+                </p>
+                </td>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="keyword">void</code>

+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.transform.notation"></a><h6>
+<a name="id944854"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.notation">Notation</a>

+        </h6>
+<div class="variablelist" title="Notation">
+<p class="title"><b>Notation</b></p>
+<dl>

+<dt><code class="computeroutput"><spanclass="identifier">Exposed</code></dt>

+<dd><p>

+ The type, <code class="computeroutput"><spanclass="identifier">Exposed</code> is

+              the type of the attribute as passed in by the user.
+            </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">Transformed</code></dt>

+<dd><p>

+ The type, <code class="computeroutput"><spanclass="identifier">Transformed</code>+ is the type of the attribute as passed along to the righthand side+ of the <code class="computeroutput"><spanclass="identifier">rule</code> (embedded+ component of <code class="computeroutput"><spanclass="identifier">attr_cast</code>).

+            </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">exposed</code></dt>

+<dd><p>

+ An instance of type <code class="computeroutput"><spanclass="identifier">Exposed</code>.

+            </p></dd>

+<dt><code class="computeroutput"><spanclass="identifier">transformed</code></dt>

+<dd><p>

+ An instance of type <code class="computeroutput"><spanclass="identifier">Transformed</code>.

+            </p></dd>
+</dl>
+</div>
+<a name="spirit.advanced.customize.transform.expression_semantics"></a><h6>
+<a name="id944992"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.expression_semantics">Expression

+          Semantics</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Expression
+                </p>
+                </th>
+<th>
+                <p>
+                  Semantics
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">transform_attribute<spanclass="special"><Exposed<spanclass="special">, Transformed<spanclass="special">>::type</code>

+                </p>
+                </td>
+<td>
+                <p>

+ Evaluates to the type to be used as the result of thetransformation+ (to be passed to the right hand side of the <codeclass="computeroutput">rule</code>+ or to the embedded component of the <codeclass="computeroutput">attr_cast</code>.+ Most of the time this is equal to <codeclass="computeroutput">Transformed</code>,+ but in other cases this might evaluate to <codeclass="computeroutput">Transformed<spanclass="special">&</code> instead avoiding superfluous

+                  object creation.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>
+
+</p>

+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";class="table-programlisting">type <spanclass="identifier">transform_attribute<spanclass="special"><Exposed<spanclass="special">, Transformed<spanclass="special">>::pre<spanclass="special">(exposed<spanclass="special">)</pre>

+<p>
+                </p>
+                </td>
+<td>
+                <p>

+ Do <code class="computeroutput"><spanclass="identifier">pre</code>-transformation+ before invoking the right hand side component for <codeclass="computeroutput">rule</code> (or theembedded component+ for <code class="computeroutput"><spanclass="identifier">attr_cast</code>).+ This takes the attribute supplied as by the user (oftype <code class="computeroutput"><spanclass="identifier">Exposed</code>) and returns the attribute+ to be passed down the component hierarchy (of the typeas exposed+ by the metafunction <code class="computeroutput"><spanclass="identifier">type</code>).+ This function will be called in <spanclass="emphasis">Qi and for

+                  <span class="emphasis"><em>Karma</em></span>.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>
+
+</p>

+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";class="table-programlisting">void <spanclass="identifier">transform_attribute<spanclass="special"><Exposed<spanclass="special">, Transformed<spanclass="special">>::post<spanclass="special">(exposed<spanclass="special">, transformed<spanclass="special">)</pre>

+<p>
+                </p>
+                </td>
+<td>
+                <p>

+ Do <code class="computeroutput"><spanclass="identifier">post</code>-transformation+ after the invocation of the right hand side componentfor <code class="computeroutput"><spanclass="identifier">rule</code> (or the embedded component+ for <code class="computeroutput"><spanclass="identifier">attr_cast</code>).+ This takes the original attribute as supplied by theuser and the+ attribute as returned from the right hand side(embedded) component+ and is expected to propagate the result back into thesupplied+ attribute instance. This function will be called inQi

+                  only.
+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>

+<aname="spirit.advanced.customize.transform.predefined_specializations"></a><h6>

+<a name="id945872"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.predefined_specializations">Predefined

+          Specializations</a>
+        </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+                <p>
+                  Template parameters
+                </p>
+                </th>
+<th>
+                <p>
+                  Semantics
+                </p>
+                </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Exposed</code>, <codeclass="computeroutput">Transformed</code>

+                </p>
+                </td>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">type</code> evaluates+ to <code class="computeroutput"><spanclass="identifier">Transformed</code>,+ <code class="computeroutput"><spanclass="identifier">pre()</code>+ returns a new instance of <codeclass="computeroutput">Transformed</code>+ constructed from the argument of type <codeclass="computeroutput">Exposed</code>,+ <code class="computeroutput"><spanclass="identifier">post()</code>+ assigns <code class="computeroutput"><spanclass="identifier">transformed</code>+ to <code class="computeroutput"><spanclass="identifier">exposed</code>.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Exposed&</code>,+ <code class="computeroutput"><spanclass="identifier">Transformed</code>

+                </p>
+                </td>
+<td>
+                <p>

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib&</code>,+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                </p>
+                </td>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">type</code> evaluates+ to <code class="computeroutput"><spanclass="identifier">Attrib&</code>,+ <code class="computeroutput"><spanclass="identifier">pre()</code>+ returns it's argument, <codeclass="computeroutput">post<spanclass="special">()</code> does nothing.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Exposed const</code>,+ <code class="computeroutput"><spanclass="identifier">Transformed</code>

+                </p>
+                </td>
+<td>
+                <p>

+ (usind in Karmaonly) <code class="computeroutput"><spanclass="identifier">type</code>+ evaluates to <code class="computeroutput"><spanclass="identifier">Transformed</code>,+ <code class="computeroutput"><spanclass="identifier">pre()</code>+ returns it's argument, <codeclass="computeroutput">post<spanclass="special">()</code> is not implemented.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib const<spanclass="special">&</code>, <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                </p>
+                </td>
+<td>
+                <p>

+ (usind in Karmaonly) <code class="computeroutput"><spanclass="identifier">type</code>+ evaluates to <code class="computeroutput"><spanclass="identifier">Attrib const<spanclass="special">&</code>,+ <code class="computeroutput"><spanclass="identifier">pre()</code>+ returns it's argument, <codeclass="computeroutput">post<spanclass="special">()</code> is not implemented.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib const</code>,+ <code class="computeroutput"><spanclass="identifier">Attrib</code>

+                </p>
+                </td>
+<td>
+                <p>

+ (usind in Karmaonly) <code class="computeroutput"><spanclass="identifier">type</code>+ evaluates to <code class="computeroutput"><spanclass="identifier">Attrib const<spanclass="special">&</code>,+ <code class="computeroutput"><spanclass="identifier">pre()</code>+ returns it's argument, <codeclass="computeroutput">post<spanclass="special">()</code> is not implemented.

+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">unused_type</code>, <codeclass="computeroutput">Attrib</code>

+                </p>
+                </td>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">type</code> evaluates+ to <code class="computeroutput"><spanclass="identifier">unused_type</code>,+ <code class="computeroutput"><spanclass="identifier">pre()</code>+ and <code class="computeroutput"><spanclass="identifier">post()</code>

+                  do nothing.
+                </p>
+                </td>
+</tr>
+<tr>
+<td>
+                <p>

+ <code class="computeroutput"><spanclass="identifier">Attrib</code>, <code class="computeroutput"><spanclass="identifier">unused_type</code>

+                </p>
+                </td>
+<td>
+                <p>

+                  do nothing.
+                </p>
+                </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.advanced.customize.transform.when_to_implement"></a><h6>
+<a name="id946576"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.when_to_implement">When

+          to implement</a>
+        </h6>
+<p>

+ The customization point <code class="computeroutput"><spanclass="identifier">transform_attribute</code>+ needs to be implemented for a specific pair of types wheneverthe attribute+ type supplied to a <code class="computeroutput"><spanclass="identifier">rule</code>+ or <code class="computeroutput"><spanclass="identifier">attr_cast</code> cannot automatically+ transformed to the attribute type expected by the right handside of the+ <code class="computeroutput"><spanclass="identifier">rule</code> (embedded component+ of the <code class="computeroutput"><spanclass="identifier">attr_cast</code>) because+ the default implementation as shown above is not applicable.Examples for+ this could be that the type <code class="computeroutput"><spanclass="identifier">Transformed</code>+ is not constructible from the type <codeclass="computeroutput">Exposed</code>.

+        </p>
+<a name="spirit.advanced.customize.transform.example"></a><h6>
+<a name="id946643"></a>

+ <a class="link"href="transform.html#spirit.advanced.customize.transform.example">Example</a>

+        </h6>
+<p>
+          TBD
+        </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
--- /dev/null

+++ /trunk/libs/spirit/doc/html/spirit/advanced/customize.html Thu Dec 323:11:44 2009

@@ -0,0 +1,170 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Customization of Spirit's Attribute Handling</title>

+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css"type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../advanced.html" title="Advanced">

+<link rel="prev" href="indepth/parsers_indepth.html" title="Parsers inDepth">+<link rel="next" href="customize/is_container.html" title="Determine if aType Should be Treated as a Container (Qi and Karma)">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

+<table cellpadding="2" width="100%"><tr>

+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../../../../boost.png"></td>

+<td align="center"><a href="../../../../../../index.html">Home</a></td>

+<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="indepth/parsers_indepth.html"><imgsrc="../../../../../../doc/html/images/prev.png" alt="Prev"></a><aaccesskey="u" href="../advanced.html"><imgsrc="../../../../../../doc/html/images/up.png" alt="Up"></a><aaccesskey="h" href="../../index.html"><imgsrc="../../../../../../doc/html/images/home.png" alt="Home"></a><aaccesskey="n" href="customize/is_container.html"><imgsrc="../../../../../../doc/html/images/next.png" alt="Next"></a>

+</div>
+<div class="section" title="Customization of Spirit's Attribute Handling">
+<div class="titlepage"><div><div><h3 class="title">

+<a name="spirit.advanced.customize"></a><a class="link"href="customize.html" title="Customization of Spirit's Attribute Handling">Customization of Spirit's

+      Attribute Handling</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section"><a href="customize/is_container.html"> Determine

+ if a Type Should be Treated as a Container (Qi andKarma)</a></dt>

+<dt><span class="section"><a href="customize/transform.html"> Transform an
+        Attribute to a Different Type (Qi and Karma)</a></span></dt>

+<dt><a href="customize/assign_to.html"> Store aParsed

+        Attribute Value (Qi)</a></span></dt>

+<dt><a href="customize/store_value.html"> StoreParsed

+        Attribute Values into a Container (Qi)</a></span></dt>

+<dt><a href="customize/clear_value.html">Re-Initialize

+        an Attribute Value before Parsing (Qi)</a></span></dt>
+<dt><span class="section"><a href="customize/extract_from.html"> Extract an
+        Attribute Value to Generate Output (Karma)</a></span></dt>

+<dt><a href="customize/iterate.html"> ExtractAttribute

+        Values to Generate Output from a Container (Karma)</a></span></dt>
+</dl></div>

+<aname="spirit.advanced.customize.why_do_we_need_attribute_customization_points"></a><h5>

+<a name="id940382"></a>

+ <a class="link"href="customize.html#spirit.advanced.customize.why_do_we_need_attribute_customization_points">Why

+        do we need Attribute Customization Points</a>
+      </h5>

+<div class="important" title="Important"><table border="0"summary="Important">

+<tr>

+<td rowspan="2" align="center" valign="top" width="25"><imgalt="[Important]" src="../../images/important.png"></td>

+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top"><p>

+ Before you read on please be aware that the interfaces describedin this+ section are not finalized and may change in the future withoutattempting+ to be backwards compatible. We document the customization pointinterfaces+ anyways as we think they are important. Understandingcustomization points+ helps understanding Spirit. Additionally they prove to bepowerful tools+ enabling full integration of the user's data structures withQi's+ parsers and Karma'sgenerators.

+        </p></td></tr>
+</table></div>
+<p>

+ <a href="http://spirit.sourceforge.net"; target="_top">Spirit</a>has been written+ with extensibility in mind. It provides many different attributecustomization+ points allowing to integrate custom data types with the process ofparsing+ in Spirit.Qi or outputgeneration with Spirit.Karma.+ All attribute customization points are exposed using a similartechnique:+ full or partial template specialization. <ahref="http://spirit.sourceforge.net"; target="_top">Spirit</a>+ generally implements the main template, providing a defaultimplementation.+ You as the user have to provide a partial or full specializationof this+ template for the data types you want to integrate with thelibrary. In fact,+ the library uses these customization points itself for instance tohandle+ the magic of the <code class="computeroutput"><spanclass="identifier">unused_type</code>

+        attribute type.
+      </p>
+<p>

+ Here is an example showing the <a class="link"href="customize/store_value/container_value.html" title="Determine the Typeto be Stored in a Container (Qi)"><code class="computeroutput"><spanclass="identifier">container_value</code></a> customization point+ used by different parsers (such as <a class="link"href="../qi/reference/operator/kleene.html" title="Kleene (*a)">Kleene</a>,+ <a class="link" href="../qi/reference/operator/plus.html"title="Plus (+a)">Plus</a>, etc.) to find

+        the attribute type to be stored in a supplied STL container:
+      </p>
+<p>
+        </p>
+<p>
+
+</p>

+<pre class="programlisting">template <spanclass="special"><typename <spanclass="identifier">Container, <spanclass="keyword">typename Enable<spanclass="comment">/* = void*/>+struct <spanclass="identifier">container_value+ : <spanclass="identifier">detail::<spanclass="identifier">remove_value_const<spanclass="special"><typename <spanclass="identifier">Container::<spanclass="identifier">value_type>

+<span class="special">{};</span>
+</pre>
+<p>
+        </p>
+<p>
+      </p>
+<p>

+ This template is instantiated by the library at the appropriateplaces while+ using the supplied container type as the template argument. Theembedded+ <code class="computeroutput"><spanclass="identifier">type</code> is used as the attribute

+        type while parsing the elements to be store in that container.
+      </p>
+<p>

+ The following example shows the predefined specialization for<code class="computeroutput"><spanclass="identifier">unused_type</code>:

+      </p>
+<p>
+        </p>
+<p>
+
+</p>

+<pre class="programlisting">template <spanclass="special"><>+struct <spanclass="identifier">container_value<spanclass="special"><unused_type<spanclass="special">>

+<span class="special">{</span>

+ typedef <spanclass="identifier">unused_type <spanclass="identifier">type;

+<span class="special">};</span>
+</pre>
+<p>
+        </p>
+<p>
+      </p>
+<p>

+ which defines its embedded <code class="computeroutput"><spanclass="identifier">type</code>+ to be <code class="computeroutput"><spanclass="identifier">unused_type</code> as well,+ this way propagating the 'don't care' attribute status to theembedded parser.

+      </p>
+<p>

+ All attribute customization points follow the same scheme. Thelast template+ parameter is always <code class="computeroutput"><spanclass="keyword">typename Enable= void</code>allowing to apply SFINAE for fine grained+ control over the template specialization process. But most of thetime you

+        can safely forget about its existence.
+      </p>
+<p>

+ The following sections will describe all customization points,together with

+        a description which needs to be specialized for what purpose.
+      </p>

+<aname="spirit.advanced.customize.the_usage_of_customization_points"></a><h5>

+<a name="id940703"></a>

+ <a class="link"href="customize.html#spirit.advanced.customize.the_usage_of_customization_points">The

+        Usage of Customization Points</a>
+      </h5>
+<p>

+ The different customizations points are used by different parts ofthe library.+ Part of the customizations points are used by both, <spanclass="emphasis">Spirit.Qi+ and Spirit.Karma, whereasothers are specialized to+ be applied for one of the sub-libraries only. We will explain whena specific+ customization point needs to be implemented and, equallyimportant, which+ customization points need to be implemented at the same time.Often it is+ not sufficient to provide a specialization for one singlecustomization point+ only, in this case you as the user have to provide all necessarycustomizations

+        for your data type you want to integrate with the library.
+      </p>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright (c) 2001-2009 Joel
+      de Guzman, Hartmut Kaiser<p>

+      </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body>
+</html>
=======================================
***Additional files exist in this changeset.***

[boost-doc-zh] r352 committed - 升级至1.41.0，第四批，libs/目录下s-t子目录

Other related posts: