C/C++ Interface

The C/C++ Interface makes it possible to integrate AH Formatter V6.3 into C/C++ programs.

CAUTION: 32-bit Windows version can be installed on Windows x64 Edition. In that case, please compile it for Win32 platform when you use C/C++ interface.

Header files

The following header files are included in [Install directory]/include.

Header file Contents Location
xfoifc.hHeader for C++ [Install directory]/include
xfoifc_c.hHeader for C

Library files

The following library files are included in [Install directory]/lib or [Install directory]/lib.

Library file Contents Location
XfoInterface63.dll C/C++ Interface Library for Windows [Install directory]
libXfoInterface.soC/C++ Interface Library for Linux / Solaris [Install directory]/lib
libXfoInterface.dylibC/C++ Interface Library for Macintosh [Install directory]/lib

In the Windows version the following library file for link is included in [Install directory]/lib.

Library file Contents Location
XfoInterface.libLibrary for DLL linking [Install directory]/lib

Compiler issues

Windows

AH Formatter V6.3 Windows version is built using Microsoft Visual C++ 2010. MFC is not used without GUI. Please use a compatible compiler for your program.

Solaris

AH Formatter V6.3 Solaris version is built using Forte Developer 7 C++ 5.4 or Sun Studio 11. Please use a compatible compiler for your program.

Linux

AH Formatter V6.3 Linux and Linux 64bit version is built using GCC 4.1. Your program must be compiled using GCC 4.1 or later. For more detailed information about GCC, please refer to "GCC, the GNU Compiler Collection".

Macintosh

AH Formatter V6.3 Macintosh version is built using GCC 4.0 contained in Mac OS X Xcode Tools.

Building the sample programs

[Install directory]/samples/cpp and [Install directory]/samples/c includes some simple sample programs.

Windows

In order to build a sample with the command line of Visual C++ in the Windows environment, execute the compiler from the console as follows.

> cd [Install directory]/samples/cpp
> cl -EHsc -I ..\..\include sample.cpp ..\..\lib\XfoInterface.lib /MT

To build the executables for Windows, use the command prompt from [Start]-[Microsoft Visual Studio 2010]-[Visual Studio Tools].

[Install directory]/lib must be appended to the PATH environment variable in order to execute this program. The sample executes as follows.

> sample sample.fo sample.pdf

Linux

The following command-line shows how to build the sample in the Linux environment using GCC.

$ cd [Install directory]/samples/cpp
$ LD_LIBRARY_PATH=../lib:${LD_LIBRARY_PATH}
$ export LD_LIBRARY_PATH
$ g++ sample.cpp -I../include -L../lib -lXfoInterface -oSamplecppcmd -lstdc++ -lpthread

In order to execute the built sample program, a setup of other environment variables is necessary. Please refer to Environment Variables for more details.

As mentioned previous, the GCC version is very important. Please check your GCC version using --version command-line option.

$ g++ --version
g++34 (GCC) 3.4.6 20060404 (Red Hat 3.4.6-4)
Copyright (C) 2006 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Solaris

The following command-line shows how to build the sample in the Solaris environment. Be sure to specify libXfoInterface.so to the linker as the library. [Install directory]/lib must be appended to LD_LIBRARY_PATH environment variable.

$ cd [Install directory]/samples/cpp
$ LD_LIBRARY_PATH=../lib:${LD_LIBRARY_PATH}
$ export LD_LIBRARY_PATH
$ CC sample.cpp -I../include -L../lib -lXfoInterface -oSamplecppcmd -mt

In order to execute the built sample program, a setup of other environment variables is necessary. Please refer to Environment Variables for more details.

API Specification

Please refer to the document that was generated by Doxygen.