Go to file

HummyPkg 090dbbc865 use size_t as return type		2017-03-09 20:44:08 +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	use size_t as return type	2017-03-09 20:44:08 +00:00
test.c	fix return value to reflect final string length	2017-03-09 20:11:34 +00:00
xconv.c	use size_t as return type	2017-03-09 20:44:08 +00:00
xconv.h	use size_t as return type	2017-03-09 20:44:08 +00:00

README.md

libxconv

Lightweight ISO-6937 to UTF-8 conversion library.

SYNOPSIS

size_t 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 excluding the string terminator.

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 buffer 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.