To use the C++ Format library, add format.h and format.cc from a release archive or the Git repository to your project. Alternatively, you can build the library with CMake.
If you are using Visual C++ with precompiled headers, you might need to add the line
#include "stdafx.h"
before other includes in format.cc.
The included CMake build script can be used to build the C++ Format library on a wide range of platforms. CMake is freely available for download from http://www.cmake.org/download/.
CMake works by generating native makefiles or project files that can be used in the compiler environment of your choice. The typical workflow starts with:
mkdir build # Create a directory to hold the build output.
cd build
cmake <path/to/cppformat> # Generate native build scripts.
where <path/to/cppformat> is a path to the cppformat repository.
If you are on a *nix system, you should now see a Makefile in the current directory. Now you can build C++ Format by running make.
Once the library has been built you can invoke make test to run the tests.
If you use Windows and have Vistual Studio installed, a FORMAT.sln file and several .vcproj files will be created. You can then build them using Visual Studio or msbuild.
On Mac OS X with Xcode installed, an .xcodeproj file will be generated.
To build a shared library set the BUILD_SHARED_LIBS CMake variable to TRUE:
cmake -DBUILD_SHARED_LIBS=TRUE ...
C++ Format provides Android.mk file that can be used to build the library with Android NDK. For an example of using C++ Format with Android NDK, see the android-ndk-example repository.