X-Git-Url: https://git.dlugolecki.net.pl/?a=blobdiff_plain;ds=inline;f=doc%2Finterface.html;h=16e66e929881da59aad88312be315266c8e1df4a;hb=d39c90b227481b9b8e6bb707570a9458618b5718;hp=68cea056841bd13363a64fd92462228750fcb435;hpb=5ae8605423ad98b85bebd61f9ecf97daa746d534;p=gedcom-parse.git diff --git a/doc/interface.html b/doc/interface.html index 68cea05..16e66e9 100644 --- a/doc/interface.html +++ b/doc/interface.html @@ -14,11 +14,11 @@
STRING
STRING
REC_INDI
XREF_PTR(INDI)
XREF_PTR(FAM),
+XREF_PTR(INDI),
+XREF_PTR(NOTE),
+XREF_PTR(OBJE),
+XREF_PTR(REPO),
+XREF_PTR(SOUR),
+XREF_PTR(SUBM),
+XREF_PTR(SUBN)
STRING
DATE
,
ELT_SUB_INDIV_BIRT,
ELT_SUB_INDIV_GEN,
- ELT_SUB_INDIV_ADOP
AGE
,
ELT_SUB_INDIV_BIRT,
ELT_SUB_INDIV_GEN,
- ELT_SUB_INDIV_ADOP
STRING
,
ELT_SUB_INDIV_BIRT,
ELT_SUB_INDIV_GEN,
- ELT_SUB_INDIV_ADOP
STRING
NULL
@@ -1519,6 +1520,7 @@ element start callback.
ELT_SUB_INDIV_BIRT,
ELT_SUB_INDIV_GEN,
ELT_SUB_INDIV_ADOP,
+ELT_SUB_INDIV_EVEN,
ELT_SUB_LIO_BAPL,
ELT_SUB_LIO_SLGC,
ELT_SUB_LSS_SLGS,
@@ -1613,7 +1615,12 @@ element start callback.
ELT_SUB_FAM_EVT
,
ELT_SUB_FAM_EVT_EVEN,
ELT_SUB_INDIV_ATTR,
- ELT_SUB_INDIV_RESI
+ ELT_SUB_INDIV_RESI,
+
+ELT_SUB_INDIV_BIRT,
+ ELT_SUB_INDIV_GEN,
+ ELT_SUB_INDIV_ADOP,
+ELT_SUB_INDIV_EVEN
STRING
@@ -1642,6 +1649,7 @@ element start callback.
ELT_SUB_INDIV_BIRT,
ELT_SUB_INDIV_GEN,
ELT_SUB_INDIV_ADOP,
+ELT_SUB_INDIV_EVEN,
ELT_SUB_LIO_BAPL,
ELT_SUB_LIO_SLGC,
ELT_SUB_LSS_SLGS,
@@ -1857,13 +1865,13 @@ the value that is returned by GEDCOM_STRING(val)
is always the s
raw_value
passed to the start callback, and is thus in fact redundant.
The date value is used for all elements that return a date. See
-here for the definition.
+here for the definition.
The xref value is for cross-references between records in the file. See
-here for the definition.
+here for the definition.
-struct date_value
+struct date_value
This struct describes a date as given in the GEDCOM file, and has the
following definition:
@@ -1991,7 +1999,7 @@ the value that is returned by GEDCOM_STRING(val)
is always the s
- struct date
+ struct date
The date1
and date2
also have a strict syntax:
@@ -2176,7 +2184,7 @@ The modifier can be one of the following:
AGE_NO_MODIFIER
: no modifierAGE_LESS_THAN
: the modifier '<' is addedAGE_GREATER_THAN
: the modifier '>' is added
-struct xref_value
+struct xref_value
This struct represents a cross-reference in the GEDCOM file (but note that
the Gedcom_val
contains a pointer to such a struct, not the struct
@@ -2200,7 +2208,9 @@ be one of:
XREF_REPO
XREF_SOUR
XREF_SUBM
- XREF_SUBN
+ XREF_SUBN
XREF_ANY
(if the type is not known, see below)
+
+
XREF_USER
(for application-specific cross-references)
@@ -2211,6 +2221,10 @@ can be filled by the application with an object (of any type) that corresponds
with the cross-reference, and then later extracted when the cross-reference
is used or defined again in the file. This relieves the application
from the burden of maintaining the mapping between cross-references and objects.
+
+The value XREF_ANY
is used when the type of the object is not
+immediately known: it has to come from further information. This is
+the case in an association (ELT_SUB_ASSO
): the type is then given by the TYPE
subtag.
The parser checks whether all cross-references that are used are defined
(if not, an error is produced) and whether all cross-references that are
@@ -2219,11 +2233,19 @@ the type of the cross-reference is the same on definition and use (if not,
an error is produced). The first two checks are done at the end of
the parsing, because cross-references can be defined after their usage in
GEDCOM.
-
+
+An xref_value can also be retrieved by its key via the following function:
+
+struct xref_value* gedcom_get_by_xref (char *key)
+
+The function returns NULL
if the given key isn't used.
$Id$
$Name$
-