Go to file

HummyPkg cbf21103b9 Add function documentation to README		2017-03-09 20:34:12 +00:00
.gitignore	Initial commit	2017-03-09 14:55:16 +00:00
charset.h	remove unecessary comment	2017-03-09 16:27:13 +00:00
LICENCE	Initial commit	2017-03-09 14:55:16 +00:00
Makefile	Do not convert existing UTF-8 sequences	2017-03-09 19:32:28 +00:00
README.md	Add function documentation to README	2017-03-09 20:34:12 +00:00
test.c	fix return value to reflect final string length	2017-03-09 20:11:34 +00:00
xconv.c	fix return value to reflect final string length	2017-03-09 20:11:34 +00:00
xconv.h	Initial commit	2017-03-09 14:55:16 +00:00

README.md

libxconv

Lightweight ISO-6937 to UTF-8 conversion library.

SYNOPSIS

int xconv(char *inbuf, char *outbuf, size_t outbuflen);

DESCRIPTION

The xconv() function converts a sequence of characters in ISO-6937 encoding to UTF-8.

If a UTF-8 sequence is found within the input string, processing is aborted.

RETURN VALUE

On successful conversion, the xconv() function returns the number of characters placed into outbuf.

If no conversion is necessary (plain ASCII input string or a UTF-8 sequence was found) then the function returns 0. In this case, the state of the output buff is undefined and it should not be used.

NOTES

This library was written to replace iconv() for a specific conversion task in a small embedded environment with little memory or CPU time available.