llvm-project/clang/examples/clang-interpreter/README.txt

This is an example of Clang based interpreter, for executing standalone C
programs.

It demonstrates the following features:
 1. Parsing standard compiler command line arguments using the Driver library.

 2. Constructing a Clang compiler instance, using the appropriate arguments
    derived in step #1.

 3. Invoking the Clang compiler to lex, parse, syntax check, and then generate
    LLVM code.

 4. Use the LLVM JIT functionality to execute the final module.

The implementation has many limitations and is not designed to be a full fledged
C interpreter. It is designed to demonstrate a simple but functional use of the
Clang compiler libraries.
Add a minimal C interpreter example. - Demonstrates how to build a standalone tool which loads source code using the Driver and Frontend libraries, and then uses CodeGen and the JIT to actually execute the code. - Still more complicated than it should be, but hey its only 153 lines. :) -- ddunbar@ozzy:tmp$ cat hello.c #include <stdio.h> int main() { printf("hello world\n"); return 0; } ddunbar@ozzy:tmp$ clang-interpreter hello.c hello world -- llvm-svn: 97133 2010-02-25 16:49:05 +08:00			`This is an example of Clang based interpreter, for executing standalone C`
			`programs.`

			`It demonstrates the following features:`
			`1. Parsing standard compiler command line arguments using the Driver library.`

			`2. Constructing a Clang compiler instance, using the appropriate arguments`
			`derived in step #1.`

			`3. Invoking the Clang compiler to lex, parse, syntax check, and then generate`
			`LLVM code.`

clang-interpreter: use LLVM interpreter if JIT is unavailable Update the strategy in r212083 to try JIT first and otherwise fall back to the interpreter. This gives the best of both worlds and still builds fine with no targets enabled. Requires supporting changes from LLVM r212086. llvm-svn: 212087 2014-07-01 11:19:50 +08:00			`4. Use the LLVM JIT functionality to execute the final module.`
Add a minimal C interpreter example. - Demonstrates how to build a standalone tool which loads source code using the Driver and Frontend libraries, and then uses CodeGen and the JIT to actually execute the code. - Still more complicated than it should be, but hey its only 153 lines. :) -- ddunbar@ozzy:tmp$ cat hello.c #include <stdio.h> int main() { printf("hello world\n"); return 0; } ddunbar@ozzy:tmp$ clang-interpreter hello.c hello world -- llvm-svn: 97133 2010-02-25 16:49:05 +08:00
			`The implementation has many limitations and is not designed to be a full fledged`
			`C interpreter. It is designed to demonstrate a simple but functional use of the`
			`Clang compiler libraries.`