Welcome to the C++ CTemplate system!
This library provides an easy to use and lightning fast text templating system to use with C++ programs.
It was originally called Google Templates, due to its origin as the template system used for Google search result pages. Now it has a more general name matching its community-owned nature.
Documentation
Refer to the Project Documentation to learn how to use the CTemplate system.
There is also a HOWTO and Examples.
Compiling
To compile test applications with these classes, run ./autogen.sh && ./configure followed by
make on unixoid platforms like Linux or MacOSX.
To install these header files on your system, run make install.
See INSTALL for more details.
This code should work on any modern C++ system. It has been tested on Linux (Ubuntu, Fedora, RedHat), Solaris 10 x86, FreeBSD 6.0, OS X 10.3 and 10.4, and Windows under both VC++7 and VC++8.
There are a few Windows-specific details; see the Windows README for more information.
CTemplate and Threads
The ctemplate library has thread support, so it works properly in a threaded environment.
For this to work, if you link libraries with -lctemplate you may also need to
add -pthread (or, on some systems, -pthreads, and on others, -lpthread) to
get the library to compile. If you leave out the -pthread, you'll see errors
like this:
symbol lookup error: /usr/local/lib/libctemplate.so.0: undefined symbol: pthread_rwlock_init
If your code isn't multi-threaded, you can instead use the ctemplate_nothreads
library: -lctemplate_nothreads.
To summarize, there are two ways to link in ctemplate in non-threaded applications. For instance:
-
Thread safe build:
gcc -o my_app my_app.o -lctemplate -pthread -
Unthreaded code:
gcc -o my_app my_app.o -lctemplate_nothreads
If your application uses threads, you should use form (1).