X-Git-Url: https://git.dlugolecki.net.pl/?a=blobdiff_plain;f=doc%2Fusage.html;h=0a8c7e85c5ece5d1352d099348de28d8366d81f0;hb=23d48363096b73555bf51f75790e3d97ba123ba1;hp=dc2e70ad7d9f03ebde68f0f2b722ca9caf204076;hpb=cf04c144fa910f52d44ef33d2fa9a03f912efa2e;p=gedcom-parse.git
diff --git a/doc/usage.html b/doc/usage.html
index dc2e70a..0a8c7e8 100644
--- a/doc/usage.html
+++ b/doc/usage.html
@@ -102,8 +102,9 @@ the -lgedcom
option
on the linking of the program as the last option, so that its initialization
code is run first. In the case of using the C object model, the linking
options should be: -lgedcom_gom -lgedcom
-
- The next sections will refine this piece of code to be able to have
+
The function gedcom_init()
also initializes locale handling by calling setlocale(LC_ALL, "")
, in case the application would not do this (it doesn't hurt for the application to do the same).
+
+The next sections will refine this piece of code to be able to have
meaningful errors and the actual data that is in the file.
gettext
mechanism in the application.
-gedcom-parse
contains an example implementation (utf8-locale.c
- and utf8-locale.h
in the "t" subdirectory of the top directory).
- Feel free to use it in your source code (it is not part of the library,
-and it isn't installed anywhere, so you need to take over the source and
-header file in your application).
see
+the "utf8" subdirectory of the top directory). Feel free to use
+ it in your source code. It isn't installed anywhere, so you need
+to take over the source and header files in your application. Note that on
+some systems it uses libcharset, which is also included in this subdirectory.
+ -The +first one returns 1 if the given input is a valid UTF-8 string, it returns +0 otherwise, the second gives the number of UTF-8 characters in the given +input. Note that the second function assumes that the input is valid +UTF-8, and gives unpredictable results if it isn't.+char *convert_utf8_to_locale (char *input, int *conv_failures);
char *convert_locale_to_utf8 (char *input);int is_utf8_string (char *input);
int utf8_strlen (char *input);
+++char *convert_utf8_to_locale (char *input, int *conv_failures);
char *convert_locale_to_utf8 (char *input);
+ Both functions return a pointer to a static buffer that is overwritten on each call. To function properly, the application must first set the locale using the
setlocale
function (the second step detailed
@@ -673,9 +686,9 @@ handle needs to be closed (when the program exits):- - The example implementation - mentioned above grows the output buffer dynamically and outputs "?" for characters + + The example implementation +mentioned above grows the output buffer dynamically and outputs "?" for characters that can't be converted.iconv_close(iconv_handle);