1.1Getting Started🔗 i

The easiest way to get started using the C metaprogramming utilities is with the main module:

This module provides everything in the entire package. Subsequent sections of this manual describe the functionality of the individual libraries included, which can also be required individually.

Binary layout information is especially useful for interacting with the foreign library—see The Racket Foreign Interface. For example, the procedures ptr-ref and ptr-set! can be used to read and write from arbitrary addresses, which can be computed using layout information.

1.2Libraries Provided by this Package🔗 i

This package includes:

• A library of abstract syntax for the C99 language–see The C Language

• A library for parsing C99 programs–see Parsing and Reading C

• A (preliminary) library providing S-expression syntax for C–see Parenthetical C

• A library for compiling and running C programs with an external compiler–see Evaluation

• A library for compiling C header information–see Header Compilation

1.3Known Limitations🔗 i

The parser does not recognize the C preprocessor. I may attempt to implement the preprocessor in the future, but there’s no guarantee at this point.

The grammar does not support any extensions for GCC, MSVC, or any other specific C implementations. I intend to add support for these extensions on a by-need basis. Specific requests (as well as patches) are welcome.

External compilation is currently limited to GCC. I intend to add support for additional compilers on a by-need basis; patches are welcome.

1.4Feedback and Bug Reports🔗 i

Before sending feedback or bug reports, please consult the current set of registered issues. If you cannot find your issue there, feel free to file a new bug report in the online issue database.

Any other feedback may be emailed to me, Dave Herman, at dherman@ccs.neu.edu.

1.5History🔗 i

• Version 0.1 (2009年02月01日) - Initial release. Reasonably usable for header extraction.

• Version 0.2 (2009年03月09日) - Full C99 parser implemented.

• Version 0.3 (2009年03月31日) - Some cleanup of the AST API.

• Version 0.4 (2009年09月16日) - Fixed parser bug 202: the grammar should be complete now.

• Version 0.5 (2012年02月26日) - Updated for Racket.