Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A collection of code samples showing usage of clang and llvm as a library
C++ C
branch: master
Failed to load latest commit information.
Win Fix Windows Build Break against mainline.
.gitignore Add Tooling example.
CIBasicRecursiveASTVisitor.cpp update mainline to svn 205387
CIrewriter.cpp update mainline to svn 205387
CItutorial1.cpp update mainline to svn 205387
CItutorial2.cpp update mainline to svn 205387
CItutorial3.cpp update mainline to svn 205387
CItutorial4.cpp update mainline to svn 205387
CItutorial6.cpp update mainline to svn 205387
CREDITS.txt Add credits.
LICENSE.txt Fix the License.
README.markdown update mainline to svn 205387
ToolingTutorial.cpp update mainline to svn 199626
compile_commands.json Add Tooling example.
input04.c Fix tutorial 6 to match the writeups.
invalidInputTest.c Handle outputing parsing error cases
makefile update mainline to svn 205387
test.c Updated the comments to point to the LICENSE.
testInclude.c Updated the comments to point to the LICENSE.
tutorial1.cpp update mainline to svn 195570
tutorial2.cpp update mainline to svn 195570
tutorial3.cpp update mainline to svn 195570
tutorial4.cpp update mainline to svn 195570
tutorial6.cpp update mainline to svn 195570



This is a collection of tutorials showing off how to use core Clang types. It is based directly on two older tutorials which no longer built due to code rot.

  1. tutorial 1 by Nico Weber - 9/28/2008
  2. tutorial 2 by Justin LaPre at Rensselaer Polytechnic Institute - 10/20/2009
  3. tutorial 3 by Larry Olson - 4/14/2012

This particular set of tutorials tracks the llvm / clang mainline and is updated semi-regularly to account for llvm / clang API changes.

See contents of the links above for a walkthrough of what these tutorials are doing.

Last Update

This was last built on 4/3/2014 against

Other Options

The Clang team has been hard at work making it easier to write tools using Clang. There are 4 options for developing tools using clang and llvm infrastructure.

Latest Stable LLVM / Clang (v3.4)

The master branch tracks recent commits to the clang and llvm svn. The tutorial assumes you have grabbed a copy of both llvm and clang by following these instructions and that you have modified the makefile of this project to point to the build's resulting llvm-config. If you want the latest public release, then checkout the 3.4 branch.

git clone
git checkout 3.4

CI tutorials

The tutorials prefixed with CI are the same as the original tutorials but use the CompilerInstance object and its helper methods to perform the same tasks as the original tutorials. For the most part, this makes the code much more compact.

Tooling tutorials

These tutorials (and the clang tooling infrastrucutre) depend on having a file called compile_commands.json which defines the commands used to compile the input file. You will need to modify this file's directory field to point to the absolute path of the Clang-tutorial on your storage.

Windows Build

Note on the Windows build: Currently the paths are hardcoded. Please see the SharedBuild.targets file inside of the SharedBuild project to update the path for your specific LLVM and CLANG install.

In particular, the LLVMLibsDirs property and the LLVMIncludes property should be updated.

Contact Me

For any questions, please ping me via my github account. Changes and additions are always welcome.

Something went wrong with that request. Please try again.