X-Git-Url: https://git.dlugolecki.net.pl/?a=blobdiff_plain;f=doc%2Fgom.html;h=a0829bcf474a82f829f455a8bd8faae82412df98;hb=23d48363096b73555bf51f75790e3d97ba123ba1;hp=f36dbd0c33ab5c7be3ac8c22fed8f4a2c06167d0;hpb=5d16fb60418c30cd6693556ac6d56d6c0f8cd7a6;p=gedcom-parse.git
diff --git a/doc/gom.html b/doc/gom.html
index f36dbd0..a0829bc 100644
--- a/doc/gom.html
+++ b/doc/gom.html
@@ -134,16 +134,16 @@ or locale-defined strings.
The following functions retrieve and set the string in UTF-8 encoding:
The first function is in fact superfluous, because it just returns thechar* gom_get_string (char* data);
-char* gom_set_string (char** data, const char* utf8_str);
+char* gom_set_string (char** data, const char* str_in_utf8);
data
, but it is there for symmetry with the functions given below for the locale-defined input and output. NULL
-if an error occurred (e.g. failure to allocate memory). It makes a
+if an error occurred (e.g. failure to allocate memory or the given string is not a valid UTF-8 string). It makes a
copy of the input string to store it in the object model. It also takes
care of deallocating the old value of the data if needed. Note that
the set function needs the address of the data variable, to be able to modify
-it.struct header* head = gom_get_header();
@@ -157,16 +157,18 @@ char* newvalue = "My_Gedcom_Tool";
A second couple of functions retrieve and set the string in the format defined by the current locale:
The use of these functions is the same as the previous ones, but e.g. in the "en_US" locale the string will be returned by the first function in the -ISO-8859-1 encoding and the second function expects thechar* gom_get_string_for_locale (char* data, int* conversion_failures);
;
-char* gom_set_string_for_locale (char** data, const char* locale_str)
+char* gom_set_string_for_locale (char** data, const char* str_in_locale);
locale_str
to be in this encoding. Conversion to and from UTF-8 for the object model is done on the fly.
+ISO-8859-1 encoding and the second function expects thestr_in_locale
to be in this encoding. Conversion to and from UTF-8 for the object model is done on the fly.
Since the conversion from UTF-8 to the locale encoding is not always possible, the get function has a second parameter that can return the number of conversion failures for the result string. Pass a pointer to an integer if you -want to know this. You can passNULL
if you're not interested.
+want to know this. You can passNULL
if you're not interested. The function returnsNULL
+if an error occurred (e.g. if the given string is not a valid string for +the current locale); in that case the target data variable is not modified.
$Id$@@ -179,4 +181,6 @@ want to know this. You can pass
$Name$NULL
if you're not interested
+
+