www.delorie.com/gnu/docs/recode/recode_16.html

search

	Buy GNU books!

The recode reference manual

4. A recoding library

The program named recode is just an application of its recoding library. The recoding library is available separately for other C programs. A good way to acquire some familiarity with the recoding library is to get acquainted with the recode program itself.

To use the recoding library once it is installed, a C program needs to have a line:

#include <recode.h>

near its beginning, and the user should have `-lrecode' on the linking call, so modules from the recoding library are found.

The library is still under development. As it stands, it contains four identifiable sets of routines: the outer level functions, the request level functions, the task level functions and the charset level functions. There are discussed in separate sections.

For effectively using the recoding library in most applications, it should be rarely needed to study anything beyond the main initialisation function at outer level, and then, various functions at request level.

4.1 Outer level functions
4.2 Request level functions
4.3 Task level functions
4.4 Charset level functions
4.5 Handling errors