Product Information for Software Developers
AutoUniConv is an automatic C charset converter. As a C library featuring a simple interface, it may fit as a component into your applications perfectly.
Your Advantages
An automatic charset conversion to a Unicode encoding scheme makes any further processing easier and more reliable.
- It ensures the expected functionality by preventing failures due to the processing of various different charsets.
- Additionally compatibility and portability between different applications or data sources increase.
- Extensions, for example with other languages, are possible without additional changes. Therefore AutoUniConv makes your work a lot easier in the future as well.
You can integrate the C library into software projects both easily and quickly and bundle it with your own software products.
- The C/C++ library provides an easy to use API.
- The API is described briefly but in detail in the manual.
- It does not cause any additional software dependencies.
- AutoUniConv is thread-safe.
A minimal introduction to the API
AutoUniConv's API has been designed as simple and compact as possible using common C/C++ design patterns and practices.
You can access the converter's functionality through two main functions that identify the used charset and provide automatic conversion: auc_conv(3) and auc_nconv(3).
Both return a pointer to a auc_bytes_t data structure that provides the string in a Unicode encoding scheme, its length and the type of the chosen scheme (e.g. "UTF-16LE") on success.
Otherwise, a pointer to NULL is returned and the thread-safe error
indicator auc_errno is set to an appropriate error code that can be
translated to a natural language error message using the function
auc_strerror(3).
Finally, any memory allocated by an auc_bytes_t data structure can be
freed conveniently using auc_free_bytes_t(3).
