Wave: a Standard conformant C++ preprocessor library

Hartmut Kaiser

Rate me:

4.96/5 (58 votes)

10 Jan 200413 min read

395K

4.4K

Describes a free and fully Standard conformant C++ preprocessor library

wave_preprocessor_src.zip
- wave
  - doc
    - acknowledgements.html
    - class_reference_context.html
    - class_reference_fileposition.html
    - class_reference_inputpolicy.html
    - class_reference_lexer.html
    - class_reference_tokentype.html
    - class_reference_tracepolicy.html
    - compiletime_config.html
    - index.html
    - introduction.html
    - macro_expansion_process.html
    - predefined_macros.html
    - preface.html
    - preliminary_cpp0x_support.html
    - quickstart.html
    - references.html
    - supported_pragmas.html
    - theme
      - bkd.gif
      - bkd2.gif
      - bullet.gif
      - l_arr.gif
      - l_arr_disabled.gif
      - r_arr.gif
      - r_arr_disabled.gif
      - style.css
      - u_arr.gif
      - uc.gif
      - wave.gif
    - token_ids.html
    - tracing_facility.html
    - wave_driver.html
  - test
    - boost-build.jam
    - cpp_tokens
    - Jamfile.v2
    - list_includes
    - project-root.jam
    - wave.vcproj
    - wave
      - cpp.cpp
      - cpp.hpp
      - cpp_config.hpp
      - cpp_version.hpp
      - instantiate_cpp_exprgrammar.cpp
      - instantiate_cpp_grammar.cpp
      - instantiate_cpp_literalgrammars.cpp
      - instantiate_defined_grammar.cpp
      - instantiate_predef_macros.cpp
      - instantiate_re2c_idllexer.cpp
      - instantiate_re2c_lexer.cpp
      - instantiate_slex_lexer.cpp
      - Jamfile
      - Jamfile.v2
      - runtests.sh
      - test_files
        
        scope1.cpp
        
        scope10.cpp
        
        scope11.cpp
        
        scope12.cpp
        
        scope13.cpp
        
        scope14.cpp
        
        scope15.cpp
        
        scope16.cpp
        
        scope17.cpp
        
        scope18.cpp
        
        scope19.cpp
        
        scope2.cpp
        
        scope20.cpp
        
        scope21.cpp
        
        scope22.cpp
        
        scope23.cpp
        
        scope24.cpp
        
        scope25.cpp
        
        scope26.cpp
        
        scope27.cpp
        
        scope3.cpp
        
        scope4.cpp
        
        scope5.cpp
        
        scope6.cpp
        
        scope7.cpp
        
        scope8.cpp
        
        scope9.cpp
        
        test1.cpp
        
        test10.cpp
        
        test11.cpp
        
        test12.cpp
        
        test13.cpp
        
        test14.cpp
        
        test15.cpp
        
        test16.cpp
        
        test17.cpp
        
        test18.cpp
        
        test19.cpp
        
        test2.cpp
        
        test20.cpp
        
        test21.cpp
        
        test22.cpp
        
        test23.cpp
        
        test24.cpp
        
        test25.cpp
        
        test26.cpp
        
        test27.cpp
        
        test28.cpp
        
        test29.cpp
        
        test3.cpp
        
        test30.cpp
        
        test31.cpp
        
        test32.cpp
        
        test33.cpp
        
        test34.cpp
        
        test35.cpp
        
        test36.cpp
        
        test37.cpp
        
        test38.cpp
        
        test39.cpp
        
        test4.cpp
        
        test40.cpp
        
        test41.cpp
        
        test41_0.hpp
        
        test41_1.hpp
        
        test42.cpp
        
        test43.cpp
        
        test44.cpp
        
        test45.cpp
        
        test46.cpp
        
        test47.cpp
        
        test48.cpp
        
        test49.cpp
        
        test5.cpp
        
        test50.cpp
        
        test51.cpp
        
        test52.cpp
        
        test53.cpp
        
        test54.cpp
        
        test55.cpp
        
        test56.cpp
        
        test57.cpp
        
        test58.cpp
        
        test59.cpp
        
        test6.cpp
        
        test60.cpp
        
        test61.cpp
        
        test62.cpp
        
        test63.cpp
        
        test64.cpp
        
        test65.cpp
        
        test66.cpp
        
        test67.cpp
        
        test68.cpp
        
        test69.cpp
        
        test7.cpp
        
        test70.cpp
        
        test71.cpp
        
        test72.cpp
        
        test73.cpp
        
        test74.cpp
        
        test75.cpp
        
        test76.cpp
        
        test77.cpp
        
        test78.cpp
        
        test79.cpp
        
        test8.cpp
        
        test9.cpp
      - trace_macro_expansion.hpp
  - wave
    - cpp_context.hpp
    - cpp_exceptions.hpp
    - cpp_iteration_context.hpp
    - cpplexer
      - cpp_lex_interface.hpp
      - cpp_lex_iterator.hpp
      - cpp_lex_token.hpp
      - cpp_token_ids.hpp
      - cpplexer_exceptions.hpp
      - macro_scoping_tokens.hpp
      - re2c_functor.hpp
      - re2clex
        
        aq.cpp
        
        aq.hpp
        
        cpp.re
        
        cpp.re.cpp
        
        cpp_re2c_lexer.hpp
        
        scanner.hpp
        
        test
        
        lextest.in
        
        lextest.output
        
        run_tests.sh
        
        test_lexer.c
        
        test_lexer.in
        
        test_lexer.output
      - slex
        
        cpp_slex_lexer.hpp
      - slex_functor.hpp
      - test
        
        instantiate_re2c_lexer.cpp
        
        instantiate_slex_lexer.cpp
        
        lextest.in
        
        lextest.re2c.output
        
        lextest.slex.output
        
        run_tests.sh
        
        test_re2c_lexer.cpp
        
        test_re2c_lexer.hpp
        
        test_slex_lexer.cpp
        
        test_slex_lexer.hpp
      - validate_universal_char.hpp
    - grammars
    - idllexer
      - idl_lex_interface.hpp
      - idl_lex_iterator.hpp
      - idl_lex_token.hpp
      - idl_token_ids.hpp
      - re2clex
        
        aq.cpp
        
        aq.hpp
        
        idl.re
        
        idl.re.cpp
        
        idl_re2c_lexer.hpp
        
        scanner.hpp
    - language_support.hpp
    - lex_iterator.hpp
    - lex_token.hpp
    - token_ids.hpp
    - trace_policies.hpp
    - util
    - wave.hpp
    - wave_version.hpp
wave_preprocessor_demo.zip
- wave.exe
wave_preprocessor_src1.zip
- acknowledgements.html
- class_reference_context.html
- class_reference_fileposition.html
- class_reference_inputpolicy.html
- class_reference_lexer.html
- class_reference_tokentype.html
- class_reference_tracepolicy.html
- compiletime_config.html
- index.html
- introduction.html
- macro_expansion_process.html
- predefined_macros.html
- preface.html
- preliminary_cpp0x_support.html
- quickstart.html
- references.html
- supported_pragmas.html
- bkd.gif
- bkd2.gif
- bullet.gif
- l_arr.gif
- l_arr_disabled.gif
- r_arr.gif
- r_arr_disabled.gif
- style.css
- u_arr.gif
- uc.gif
- wave.gif
- token_ids.html
- tracing_facility.html
- wave_driver.html
- boost-build.jam
- cpp_tokens.cpp
- cpp_tokens_config.hpp
- instantiate_cpp_exprgrammar.cpp
- instantiate_cpp_grammar.cpp
- instantiate_cpp_literalgrammars.cpp
- instantiate_re2c_lexer.cpp
- instantiate_slex_lexer.cpp
- Jamfile.v2
- instantiate_cpp_exprgrammar.cpp
- instantiate_cpp_grammar.cpp
- instantiate_cpp_literalgrammars.cpp
- instantiate_re2c_lexer.cpp
- instantiate_slex_lexer.cpp
- list_includes.cpp
- list_includes.hpp
- list_includes_version.hpp
- Readme.txt
- project-root.jam
- wave.vcproj
- cpp.cpp
- cpp.hpp
- cpp_config.hpp
- cpp_version.hpp
- instantiate_cpp_exprgrammar.cpp
- instantiate_cpp_grammar.cpp
- instantiate_cpp_literalgrammars.cpp
- instantiate_defined_grammar.cpp
- instantiate_predef_macros.cpp
- instantiate_re2c_lexer.cpp
- instantiate_slex_lexer.cpp
- Jamfile
- Jamfile.v2
- runtests.sh
- test1.cpp
- test10.cpp
- test11.cpp
- test12.cpp
- test13.cpp
- test14.cpp
- test15.cpp
- test16.cpp
- test17.cpp
- test18.cpp
- test19.cpp
- test2.cpp
- test20.cpp
- test21.cpp
- test22.cpp
- test23.cpp
- test24.cpp
- test25.cpp
- test26.cpp
- test27.cpp
- test28.cpp
- test29.cpp
- test3.cpp
- test30.cpp
- test31.cpp
- test32.cpp
- test33.cpp
- test4.cpp
- test5.cpp
- test6.cpp
- test7.cpp
- test8.cpp
- test9.cpp
- trace_macro_expansion.hpp
- cpp_context.hpp
- cpp_exceptions.hpp
- cpp_iteration_context.hpp
- cpp_lex_interface.hpp
- cpp_lex_iterator.hpp
- cpp_lex_token.hpp
- cpp_token_ids.hpp
- cpplexer_exceptions.hpp
- macro_scoping_tokens.hpp
- re2c_functor.hpp
- aq.cpp
- aq.hpp
- cpp.re
- cpp.re.cpp
- cpp_re2c_lexer.hpp
- scanner.hpp
- lextest.in
- lextest.output
- run_tests.sh
- test_lexer.c
- test_lexer.in
- test_lexer.output
- cpp_slex_lexer.hpp
- slex_functor.hpp
- instantiate_re2c_lexer.cpp
- instantiate_slex_lexer.cpp
- lextest.in
- lextest.re2c.output
- lextest.slex.output
- run_tests.sh
- test_re2c_lexer.cpp
- test_re2c_lexer.hpp
- test_slex_lexer.cpp
- test_slex_lexer.hpp
- validate_universal_char.hpp
- cpp_chlit_grammar.hpp
- cpp_defined_grammar.hpp
- cpp_defined_grammar_gen.hpp
- cpp_expression_grammar.hpp
- cpp_expression_grammar_gen.hpp
- cpp_floatlit_grammar.hpp
- cpp_grammar.hpp
- cpp_grammar_gen.hpp
- cpp_intlit_grammar.hpp
- cpp_literal_grammar_gen.hpp
- cpp_predef_macros_gen.hpp
- cpp_predef_macros_grammar.hpp
- language_support.hpp
- macro_trace_policies.hpp
- cpp_ifblock.hpp
- cpp_include_pathes.hpp
- cpp_iterator.hpp
- cpp_macromap.hpp
- eat_whitespace.hpp
- file_position.hpp
- flex_string.hpp
- insert_whitespace_detection.hpp
- interpret_pragma.hpp
- iteration_context.hpp
- macro_definition.hpp
- macro_helpers.hpp
- pattern_parser.hpp
- symbol_table.hpp
- time_conversion_helper.hpp
- transform_iterator.hpp
- unput_queue_iterator.hpp
- wave_version.hpp
wave_preprocessor_demo1.zip
- wave.exe

Wave: A Standard compliant C++ preprocessor
Sample: List include dependencies of a given source file

    Copyright (c) 2001-2004 Hartmut Kaiser
    http://spirit.sourceforge.net/

    Use, modification and distribution is subject to the Boost Software
    License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
    http://www.boost.org/LICENSE_1_0.txt)

    See Copyright.txt for full acknowledgements.

-------------------------------------------------------------------------------

The 'list_includes' sample shows a simple way, how to use the C++ preprocessor
iterator library to extract a list of included files from a given source file. 
To get a hint which commandline options are supported, call it with the --help
option.

Note: This sample requires the program_options library written by Vladimir Prus,
which is currently under Boost review. 
It is available here: http://boost-sandbox.sourceforge.net/program_options.

The build process is straightforward. The only thing you should do 
is to include the root directory of the Wave library into the include search
path of your compiler (usually through a -I../.. command line argument).

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Written By

Hartmut Kaiser

United States

Actively involved in Boost and the development of the Spirit parser construction framework.

Wave: a Standard conformant C++ preprocessor library

License

Comments and Discussions