X-Git-Url: https://git.dlugolecki.net.pl/?a=blobdiff_plain;f=doc%2Finterface.html;h=eb3c4f05cd880d26d69e37d8ba62618de0d6530d;hb=d41803b9c1bcafabf115a188e3b4a489103bbdca;hp=057a31eddd18e3070581e024b0e236507cede5fc;hpb=f789da85454184a473145e9a1d1260b9e09afcd1;p=gedcom-parse.git diff --git a/doc/interface.html b/doc/interface.html index 057a31e..eb3c4f0 100644 --- a/doc/interface.html +++ b/doc/interface.html @@ -1,2049 +1,2694 @@ - - - - Libgedcom interface details - - - - - +Libgedcom interface details + + + +

Libgedcom interface details

-
- +
+

Index

- -

Record identifiers
Element identifiers
Gedcom_val types

Record identifiers
Element identifiers
Gedcom_val types

struct date_value
struct date
-
struct date_value
struct date
struct age_value
+
struct xref_value
+

Record identifiers


-  Gedcom_val

type

xref

Record -	Meaning -	Possible - `xref` types -
`REC_HEAD` -	The header of the GEDCOM file -	`NULL` -
`REC_FAM` -	A record describing a family -	`STRING` -
`REC_INDI` -	A record describing an individual -	`STRING` -
`REC_OBJE` -	A record describing a multimedia object -	`STRING` -
`REC_NOTE` -	A record describing a note -	`STRING` -
`REC_REPO` -	A record describing a source repository -	`STRING` -
`REC_SOUR` -	A record describing a source -	`STRING` -
`REC_SUBN` -	A record describing the submission -	`STRING` -
`REC_SUBM` -	A record describing the submitter -	`STRING` -
`REC_USER` -	An application-specific record (the `tag` - in the start callback contains the actually used tag). -	`NULL` - `STRING` -

Element identifiers


-   Gedcom_val

type

val


+    Gedcom_val

type

xref


+val

Element -	Possible - tags - -	Used within -	Possible - `val` types - -
`ELT_HEAD_SOUR` -	`SOUR` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_SOUR_VERS` -	`VERS` -	`ELT_HEAD_SOUR` -	`STRING` -
`ELT_HEAD_SOUR_NAME` -	`NAME` -	`ELT_HEAD_SOUR` -	`STRING` -
`ELT_HEAD_SOUR_CORP` -	`CORP` -	`ELT_HEAD_SOUR` -	`STRING` -
`ELT_HEAD_SOUR_DATA` -	`DATA` -	`ELT_HEAD_SOUR` -	`STRING` -
`ELT_HEAD_SOUR_DATA_DATE` -	`DATE` -	`ELT_HEAD_SOUR_DATA` -	`DATE` -
`ELT_HEAD_SOUR_DATA_COPR` -	`COPR` -	`ELT_HEAD_SOUR_DATA` -	`STRING` -
`ELT_HEAD_DEST` -	`DEST` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_DATE` -	`DATE` -	`REC_HEAD` -	`DATE` -
`ELT_HEAD_DATE_TIME` -	`TIME` -	`ELT_HEAD_DATE` -	`STRING` -
`ELT_HEAD_SUBM` -	`SUBM` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_SUBN` -	`SUBN` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_FILE` -	`FILE` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_COPR` -	`COPR` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_GEDC` -	`GEDC` -	`REC_HEAD` -	`NULL` -
`ELT_HEAD_GEDC_VERS` -	`VERS` -	`ELT_HEAD_GEDC` -	`STRING` -
`ELT_HEAD_GEDC_FORM` -	`FORM` -	`ELT_HEAD_GEDC` -	`STRING` -
`ELT_HEAD_CHAR` -	`CHAR` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_CHAR_VERS` -	`VERS` -	`ELT_HEAD_CHAR` -	`STRING` -
`ELT_HEAD_LANG` -	`LANG` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_PLAC` -	`PLAC` -	`REC_HEAD` -	`NULL` -
`ELT_HEAD_PLAC_FORM` -	`FORM` -	`ELT_HEAD_PLAC` -	`STRING` -
`ELT_HEAD_NOTE` -	`NOTE` -	`REC_HEAD` -	`STRING` -
`ELT_FAM_HUSB` -	`HUSB` -	`REC_FAM` -	`STRING` -
`ELT_FAM_WIFE` -	`WIFE` -	`REC_FAM` -	`STRING` -
`ELT_FAM_CHIL` -	`CHIL` -	`REC_FAM` -	`STRING` -
`ELT_FAM_NCHI` -	`NCHI` -	`REC_FAM` -	`STRING` -
`ELT_FAM_SUBM` -	`SUBM` -	`REC_FAM` -	`STRING` -
`ELT_INDI_RESN` -	`RESN` -	`REC_INDI` -	`STRING` -
`ELT_INDI_SEX` -	`SEX` -	`REC_INDI` -	`STRING` -
`ELT_INDI_SUBM` -	`SUBM` -	`REC_INDI` -	`STRING` -
`ELT_INDI_ALIA` -	`ALIA` -	`REC_INDI` -	`STRING` -
`ELT_INDI_ANCI` -	`ANCI` -	`REC_INDI` -	`STRING` -
`ELT_INDI_DESI` -	`DESI` -	`REC_INDI` -	`STRING` -
`ELT_INDI_RFN` -	`RFN` -	`REC_INDI` -	`STRING` -
`ELT_INDI_AFN` -	`AFN` -	`REC_INDI` -	`STRING` -
`ELT_OBJE_FORM` -	`FORM` -	`REC_OBJE` -	`STRING` -
`ELT_OBJE_TITL` -	`TITL` -	`REC_OBJE` -	`STRING` -
`ELT_OBJE_BLOB` -	`BLOB` -	`REC_OBJE` -	`NULL` -
`ELT_OBJE_BLOB_CONT` -	`CONT` -	`ELT_OBJE_BLOB` -	`STRING` -
`ELT_OBJE_OBJE` -	`OBJE` -	`REC_OBJE` -	`STRING` -
`ELT_REPO_NAME` -	`NAME` -	`REC_REPO` -	`STRING` -
`ELT_SOUR_DATA` -	`DATA` -	`REC_SOUR` -	`NULL` -
`ELT_SOUR_DATA_EVEN` -	`EVEN` -	`ELT_SOUR_DATA` -	`STRING` -
`ELT_SOUR_DATA_EVEN_DATE` -	`DATE` -	`ELT_SOUR_DATA_EVEN` -	`DATE` -
`ELT_SOUR_DATA_EVEN_PLAC` -	`PLAC` -	`ELT_SOUR_DATA_EVEN` -	`STRING` -
`ELT_SOUR_DATA_AGNC` -	`AGNC` -	`ELT_SOUR_DATA` -	`STRING` -
`ELT_SOUR_AUTH` -	`AUTH` -	`REC_SOUR` -	`STRING` -
`ELT_SOUR_TITL` -	`TITL` -	`REC_SOUR` -	`STRING` -
`ELT_SOUR_ABBR` -	`ABBR` -	`REC_SOUR` -	`STRING` -
`ELT_SOUR_PUBL` -	`PUBL` -	`REC_SOUR` -	`STRING` -
`ELT_SOUR_TEXT` -	`TEXT` -	`REC_SOUR` -	`STRING` -
`ELT_SUBN_SUBM` -	`SUBM` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_FAMF` -	`FAMF` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_TEMP` -	`TEMP` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_ANCE` -	`ANCE` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_DESC` -	`DESC` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_ORDI` -	`ORDI` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_RIN` -	`RIN` -	`REC_SUBN` -	`STRING` -
`ELT_SUBM_NAME` -	`NAME` -	`REC_SUBM` -	`STRING` -
`ELT_SUBM_LANG` -	`LANG` -	`REC_SUBM` -	`STRING` -
`ELT_SUBM_RFN` -	`RFN` -	`REC_SUBM` -	`STRING` -
`ELT_SUBM_RIN` -	`RIN` -	`REC_SUBM` -	`STRING` -
`ELT_SUB_ADDR` -	`ADDR` -	`ELT_HEAD_SOUR_CORP, - REC_REPO, REC_SUBM, -ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP -` - -	`STRING` -
`ELT_SUB_ADDR_CONT` -	`CONT` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_ADR1` -	`ADR1` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_ADR2` -	`ADR2` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_CITY` -	`CITY` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_STAE` -	`STAE` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_POST` -	`POST` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_CTRY` -	`CTRY` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_PHON` -	`PHON` -	`ELT_HEAD_SOUR_CORP, - REC_REPO, REC_SUBM, -ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP -` - -	`STRING` -
`ELT_SUB_ASSO` -	`ASSO` -	`REC_INDI` -	`STRING` -
`ELT_SUB_ASSO_TYPE` -	`TYPE` -	`ELT_SUB_ASSO` -	`STRING` -
`ELT_SUB_ASSO_RELA` -	`RELA` -	`ELT_SUB_ASSO` -	`STRING` -
`ELT_SUB_CHAN` -	`CHAN` -	`REC_FAM, REC_INDI, - REC_OBJE, REC_NOTE, - REC_REPO, REC_SOUR, - REC_SUBM -` -	`NULL` -
`ELT_SUB_CHAN_DATE` -	`DATE` -	`ELT_SUB_CHAN` -	`DATE` -
`ELT_SUB_CHAN_TIME` -	`TIME` -	`ELT_SUB_CHAN_DATE` -	`STRING` -
`ELT_SUB_FAMC` -	`FAMC` -	`REC_INDI` -	`STRING` -
`ELT_SUB_FAMC_PEDI` -	`PEDI` -	`ELT_SUB_FAMC` -	`STRING` -
`ELT_SUB_CONT` -	`CONT` -	`ELT_HEAD_NOTE, REC_NOTE, - ELT_SOUR_AUTH, ELT_SOUR_TITL, - ELT_SOUR_PUBL, ELT_SOUR_TEXT, - ELT_SUB_NOTE, - ELT_SUB_SOUR, ELT_SUB_SOUR_TEXT -` -	`STRING` -
`ELT_SUB_CONC` -	`CONC` -	`ELT_HEAD_NOTE, REC_NOTE, - ELT_SOUR_AUTH, ELT_SOUR_TITL, - ELT_SOUR_PUBL, ELT_SOUR_TEXT, - ELT_SUB_NOTE, - ELT_SUB_SOUR, ELT_SUB_SOUR_TEXT -` -	`STRING` -
`ELT_SUB_EVT_TYPE` -	`TYPE` -	`ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP -` -	`STRING` -
`ELT_SUB_EVT_DATE` -	`DATE` -	`ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP -` - - -	`DATE` -
`ELT_SUB_EVT_AGE` -	`AGE` -	`ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP` - - -	`STRING` -
`ELT_SUB_EVT_AGNC` -	`AGNC` -	`ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP` - - -	`STRING` -
`ELT_SUB_EVT_CAUS` -	`CAUS` -	`ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP` - - -	`STRING` -
`ELT_SUB_FAM_EVT` -	`ANUL, CENS, DIV, - DIVF, ENGA, MARR, - MARB, MARC, MARL, - MARS` -	`REC_FAM` -	`NULL - STRING` -
`ELT_SUB_FAM_EVT_HUSB` -	`HUSB` -	`ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN` -	`NULL` -
`ELT_SUB_FAM_EVT_WIFE` -	`WIFE` -	`ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN` -	`NULL` -
`ELT_SUB_FAM_EVT_AGE` -	`AGE` -	`ELT_SUB_FAM_EVT_HUSB`, - `ELT_SUB_FAM_EVT_WIFE` -	`STRING` -
`ELT_SUB_FAM_EVT_EVEN` -	`EVEN` -	`REC_FAM` -	`NULL` -
`ELT_SUB_IDENT_REFN` -	`REFN` -	`REC_FAM, REC_INDI, - REC_OBJE, REC_NOTE, - REC_REPO, REC_SOUR -` -	`STRING` -
`ELT_SUB_IDENT_REFN_TYPE` -	`TYPE` -	`ELT_SUB_IDENT_REFN` -	`STRING` -
`ELT_SUB_IDENT_RIN` -	`RIN` -	`REC_FAM, REC_INDI, - REC_OBJE, REC_NOTE, - REC_REPO, REC_SOUR -` -	`STRING` -
`ELT_SUB_INDIV_ATTR` -	`CAST, DSCR, EDUC, - IDNO, NATI, NCHR, - NMR, OCCU, PROP, - RELI, SSN, TITL` -	`REC_INDI` -	`STRING` -
`ELT_SUB_INDIV_RESI` -	`RESI` -	`REC_INDI` -	`NULL` -
`ELT_SUB_INDIV_BIRT` -	`BIRT, CHR` -	`REC_INDI` -	`NULL - STRING` -
`ELT_SUB_INDIV_BIRT_FAMC` -	`FAMC` -	`ELT_SUB_INDIV_BIRT` -	`STRING` -
`ELT_SUB_INDIV_GEN` -	`DEAT, BURI, CREM, - BAPM, BARM, BASM, - BLES, CHRA, CONF, - FCOM, ORDN, NATU, - EMIG, IMMI, CENS, - PROB, WILL, GRAD, - RETI` -	`REC_INDI` -	`NULL - STRING` -
`ELT_SUB_INDIV_ADOP` -	`ADOP` -	`REC_INDI` -	`NULL - STRING` -
`ELT_SUB_INDIV_ADOP_FAMC` -	`FAMC` -	`ELT_SUB_INDIV_ADOP` -	`STRING` -
`ELT_SUB_INDIV_ADOP_FAMC_ADOP` -	`ADOP` -	`ELT_SUB_INDIV_ADOP_FAMC` -	`STRING` -
`ELT_SUB_INDIV_EVEN` -	`EVEN` -	`REC_INDI` -	`NULL` -
`ELT_SUB_LIO_BAPL` -	`BAPL, CONL, ENDL` -	`REC_INDI` -	`NULL` -
`ELT_SUB_LIO_BAPL_STAT` -	`STAT` -	`ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC -` -	`STRING` -
`ELT_SUB_LIO_BAPL_DATE` -	`DATE` -	`ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC -` - -	`DATE` -
`ELT_SUB_LIO_BAPL_TEMP` -	`TEMP` -	`ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC -` - -	`STRING` -
`ELT_SUB_LIO_BAPL_PLAC` -	`PLAC` -	`ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC -` - -	`STRING` -
`ELT_SUB_LIO_SLGC` -	`SLGC` -	`REC_INDI` -	`NULL` -
`ELT_SUB_LIO_SLGC_FAMC` -	`FAMC` -	`ELT_SUB_LIO_SLGC` -	`STRING` -
`ELT_SUB_LSS_SLGS` -	`SLGS` -	`REC_FAM` -	`NULL` -
`ELT_SUB_LSS_SLGS_STAT` -	`STAT` -	`ELT_SUB_LSS_SLGS` -	`STRING` -
`ELT_SUB_LSS_SLGS_DATE` -	`DATE` -	`ELT_SUB_LSS_SLGS` -	`DATE` -
`ELT_SUB_LSS_SLGS_TEMP` -	`TEMP` -	`ELT_SUB_LSS_SLGS` -	`STRING` -
`ELT_SUB_LSS_SLGS_PLAC` -	`PLAC` -	`ELT_SUB_LSS_SLGS` -	`STRING` -
`ELT_SUB_MULTIM_OBJE` -	`OBJE` -	`REC_FAM, REC_INDI, - REC_SOUR, REC_SUBM, -ELT_SUB_FAM_EVT, - ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP, - ELT_SUB_SOUR` -	`NULL` -
`ELT_SUB_MULTIM_OBJE_FORM` -	`FORM` -	`ELT_SUB_MULTIM_OBJE` -	`STRING` -
`ELT_SUB_MULTIM_OBJE_TITL` -	`TITL` -	`ELT_SUB_MULTIM_OBJE` -	`STRING` -
`ELT_SUB_MULTIM_OBJE_FILE` -	`FILE` -	`ELT_SUB_MULTIM_OBJE` -	`STRING` -
`ELT_SUB_NOTE` -	`NOTE` -	`REC_FAM, REC_INDI, - REC_OBJE, REC_REPO, - REC_SOUR, ELT_SOUR_DATA, - ELT_SUB_ASSO, ELT_SUB_CHAN, - ELT_SUB_FAMC,ELT_SUB_FAM_EVT, - ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP, - ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC, - ELT_SUB_LSS_SLGS, - ELT_SUB_MULTIM_OBJE, - ELT_SUB_PERS_NAME, - ELT_SUB_PLAC, - ELT_SUB_SOUR, - ELT_SUB_REPO, - ELT_SUB_FAMS` -	`NULL - STRING` -
`ELT_SUB_PERS_NAME` -	`NAME` -	`REC_INDI` -	`STRING` -
`ELT_SUB_PERS_NAME_NPFX` -	`NPFX` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_GIVN` -	`GIVN` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_NICK` -	`NICK` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_SPFX` -	`SPFX` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_SURN` -	`SURN` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_NSFX` -	`NSFX` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PLAC` -	`PLAC` -	`ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI` -	`STRING` -
`ELT_SUB_PLAC_FORM` -	`FORM` -	`ELT_SUB_PLAC` -	`STRING` -
`ELT_SUB_SOUR` -	`SOUR` -	`REC_FAM, REC_INDI, - REC_NOTE, ELT_SUB_ASSO -ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, - ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP, - ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC, - ELT_SUB_LSS_SLGS, - ELT_SUB_NOTE, - ELT_SUB_PERS_NAME, - ELT_SUB_PLAC` -	`STRING` -
`ELT_SUB_SOUR_PAGE` -	`PAGE` -	`ELT_SUB_SOUR` -	`STRING` -
`ELT_SUB_SOUR_EVEN` -	`EVEN` -	`ELT_SUB_SOUR` -	`STRING` -
`ELT_SUB_SOUR_EVEN_ROLE` -	`ROLE` -	`ELT_SUB_SOUR_EVEN` -	`STRING` -
`ELT_SUB_SOUR_DATA` -	`DATA` -	`ELT_SUB_SOUR` -	`NULL` -
`ELT_SUB_SOUR_DATA_DATE` -	`DATE` -	`ELT_SUB_SOUR_DATA` -	`DATE` -
`ELT_SUB_SOUR_TEXT` -	`TEXT` -	`ELT_SUB_SOUR - ELT_SUB_SOUR_DATA` -	`STRING` -
`ELT_SUB_SOUR_QUAY` -	`QUAY` -	`ELT_SUB_SOUR` -	`STRING` -
`ELT_SUB_REPO` -	`REPO` -	`REC_SOUR` -	`STRING` -
`ELT_SUB_REPO_CALN` -	`CALN` -	`ELT_SUB_REPO` -	`STRING` -
`ELT_SUB_REPO_CALN_MEDI` -	`MEDI` -	`ELT_SUB_REPO_CALN` -	`STRING` -
`ELT_SUB_FAMS` -	`FAMS` -	`REC_INDI` -	`STRING` -
`ELT_USER` -	`any tag starting - with an underscore` -	`anywhere` -	`NULL - STRING` -

Record +	Meaning +	Possible + `xref` types +	Possible start + `val` types +	Possible end + `val` types +
`REC_HEAD` +	The header of the GEDCOM file +	`NULL` +	`NULL` +	`NULL` +
`REC_FAM` +	A record describing a family +	`XREF_PTR(FAM)` +	`NULL` +	`NULL` +
`REC_INDI` +	A record describing an individual +	`XREF_PTR(INDI)` +	`NULL` +	`NULL` +
`REC_OBJE` +	A record describing a multimedia object +	`XREF_PTR(OBJE)` +	`NULL` +	`NULL` +
`REC_NOTE` +	A record describing a note +	`XREF_PTR(NOTE)` +	`STRING` +	`STRING` +
`REC_REPO` +	A record describing a source repository +	`XREF_PTR(REPO)` +	`NULL` +	`NULL` +
`REC_SOUR` +	A record describing a source +	`XREF_PTR(SOUR)` +	`NULL` +	`NULL` +
`REC_SUBN` +	A record describing the submission +	`XREF_PTR(SUBN)` +	`NULL` +	`NULL` +
`REC_SUBM` +	A record describing the submitter +	`XREF_PTR(SUBM`) +	`NULL` +	`NULL` +
`REC_USER` +	An application-specific record (the `tag` + in the start callback contains the actually used tag). +	`NULL + XREF_PTR(USER) +` +	`NULL + STRING + XREF_PTR(USER)` +	`NULL` +

Gedcom_val types
-

Gedcom_val


- val

Gedcom_val

-	type checker -	cast operator -
null value -	`GEDCOM_IS_NULL(val)` -	N/A -
string -	`GEDCOM_IS_STRING(val)` -	`char* str = GEDCOM_STRING(val);` -
date -	`GEDCOM_IS_DATE(val)` -	`struct date_value dv = GEDCOM_DATE(val);`

struct date_value

struct date_value { - Date_value_type type; - struct date date1; - struct date date2; - char phrase[MAX_PHRASE_LEN - + 1]; - };
-

Element identifiers


+     Gedcom_val

type

val

Date_value_type +	Element +	Possible + tags + +	Used within +	Possible start + `val` types + +	Possible end + `val` types +
`ELT_HEAD_SOUR` +	`SOUR` +	`REC_HEAD` +	`STRING` +	`NULL` +
`ELT_HEAD_SOUR_VERS` +	`VERS` +	`ELT_HEAD_SOUR` +	`STRING` +	`NULL` +
`ELT_HEAD_SOUR_NAME` +	`NAME` +	`ELT_HEAD_SOUR` +	`STRING` +	`NULL` +
`ELT_HEAD_SOUR_CORP` +	`CORP` +	`ELT_HEAD_SOUR` +	`STRING` +	`NULL` +
`ELT_HEAD_SOUR_DATA` +	`DATA` +	`ELT_HEAD_SOUR` +	`STRING` +	`NULL` +
`ELT_HEAD_SOUR_DATA_DATE` +	`DATE` +	`ELT_HEAD_SOUR_DATA` +	`DATE` +	`NULL` +
`ELT_HEAD_SOUR_DATA_COPR` +	`COPR` +	`ELT_HEAD_SOUR_DATA` +	`STRING` +	`NULL` +
`ELT_HEAD_DEST` +	`DEST` +	`REC_HEAD` +	`STRING` +	`NULL` +
`ELT_HEAD_DATE` +	`DATE` +	`REC_HEAD` +	`DATE` +	`NULL` +
`ELT_HEAD_DATE_TIME` +	`TIME` +	`ELT_HEAD_DATE` +	`STRING` +	`NULL` +
`ELT_HEAD_SUBM` +	`SUBM` +	`REC_HEAD` +	`XREF_PTR(SUBM)` +	`NULL` +
`ELT_HEAD_SUBN` +	`SUBN` +	`REC_HEAD` +	`XREF_PTR(SUBN)` +	`NULL` +
`ELT_HEAD_FILE` +	`FILE` +	`REC_HEAD` +	`STRING` +	`NULL` +
`ELT_HEAD_COPR` +	`COPR` +	`REC_HEAD` +	`STRING` +	`NULL` +
`ELT_HEAD_GEDC` +	`GEDC` +	`REC_HEAD` +	`NULL` +	`NULL` +
`ELT_HEAD_GEDC_VERS` +	`VERS` +	`ELT_HEAD_GEDC` +	`STRING` +	`NULL` +
`ELT_HEAD_GEDC_FORM` +	`FORM` +	`ELT_HEAD_GEDC` +	`STRING` +	`NULL` +
`ELT_HEAD_CHAR` +	`CHAR` +	`REC_HEAD` +	`STRING` +	`NULL` +
`ELT_HEAD_CHAR_VERS` +	`VERS` +	`ELT_HEAD_CHAR` +	`STRING` +	`NULL` +
`ELT_HEAD_LANG` +	`LANG` +	`REC_HEAD` +	`STRING` +	`NULL` +
`ELT_HEAD_PLAC` +	`PLAC` +	`REC_HEAD` +	`NULL` +	`NULL` +
`ELT_HEAD_PLAC_FORM` +	`FORM` +	`ELT_HEAD_PLAC` +	`STRING` +	`NULL` +
`ELT_HEAD_NOTE` +	`NOTE` +	`REC_HEAD` +	`STRING` +	`STRING` +
`ELT_FAM_HUSB` +	`HUSB` +	`REC_FAM` +	`XREF_PTR(INDI)` +	`NULL` +
`ELT_FAM_WIFE` +	`WIFE` +	`REC_FAM` +	`XREF_PTR(INDI)` +	`NULL` +
`ELT_FAM_CHIL` +	`CHIL` +	`REC_FAM` +	`XREF_PTR(INDI)` +	`NULL` +
`ELT_FAM_NCHI` +	`NCHI` +	`REC_FAM` +	`STRING` +	`NULL` +
`ELT_FAM_SUBM` +	`SUBM` +	`REC_FAM` +	`XREF_PTR(SUBM)` +	`NULL` +
`ELT_INDI_RESN` +	`RESN` +	`REC_INDI` +	`STRING` +	`NULL` +
`ELT_INDI_SEX` +	`SEX` +	`REC_INDI` +	`STRING` +	`NULL` +
`ELT_INDI_SUBM` +	`SUBM` +	`REC_INDI` +	`XREF_PTR(SUBM)` +	`NULL` +
`ELT_INDI_ALIA` +	`ALIA` +	`REC_INDI` +	`XREF_PTR(INDI)` +	`NULL` +
`ELT_INDI_ANCI` +	`ANCI` +	`REC_INDI` +	`XREF_PTR(SUBM)` +	`NULL` +
`ELT_INDI_DESI` +	`DESI` +	`REC_INDI` +	`XREF_PTR(SUBM)` +	`NULL` +
`ELT_INDI_RFN` +	`RFN` +	`REC_INDI` +	`STRING` +	`NULL` +
`ELT_INDI_AFN` +	`AFN` +	`REC_INDI` +	`STRING` +	`NULL` +
`ELT_OBJE_FORM` +	`FORM` +	`REC_OBJE` +	`STRING` +	`NULL` +
`ELT_OBJE_TITL` +	`TITL` +	`REC_OBJE` +	`STRING` +	`NULL` +
`ELT_OBJE_BLOB` +	`BLOB` +	`REC_OBJE` +	`NULL` +	`STRING` +
`ELT_OBJE_BLOB_CONT` +	`CONT` +	`ELT_OBJE_BLOB` +	`STRING` +	`NULL` +
`ELT_OBJE_OBJE` +	`OBJE` +	`REC_OBJE` +	`XREF_PTR(OBJE)` +	`NULL` +
`ELT_REPO_NAME` +	`NAME` +	`REC_REPO` +	`STRING` +	`NULL` +
`ELT_SOUR_DATA` +	`DATA` +	`REC_SOUR` +	`NULL` +	`NULL` +
`ELT_SOUR_DATA_EVEN` +	`EVEN` +	`ELT_SOUR_DATA` +	`STRING` +	`NULL` +
`ELT_SOUR_DATA_EVEN_DATE` +	`DATE` +	`ELT_SOUR_DATA_EVEN` +	`DATE` +	`NULL` +
`ELT_SOUR_DATA_EVEN_PLAC` +	`PLAC` +	`ELT_SOUR_DATA_EVEN` +	`STRING` +	`NULL` +
`ELT_SOUR_DATA_AGNC` +	`AGNC` +	`ELT_SOUR_DATA` +	`STRING` +	`NULL` +
`ELT_SOUR_AUTH` +	`AUTH` +	`REC_SOUR` +	`STRING` +	`STRING` +
`ELT_SOUR_TITL` +	`TITL` +	`REC_SOUR` +	`STRING` +	`STRING` +
`ELT_SOUR_ABBR` +	`ABBR` +	`REC_SOUR` +	`STRING` +	`NULL` +
`ELT_SOUR_PUBL` +	`PUBL` +	`REC_SOUR` +	`STRING` +	`STRING` +
`ELT_SOUR_TEXT` +	`TEXT` +	`REC_SOUR` +	`STRING` +	`STRING` +
`ELT_SUBN_SUBM` +	`SUBM` +	`REC_SUBN` +	`XREF_PTR(SUBM)` +	`NULL` +
`ELT_SUBN_FAMF` +	`FAMF` +	`REC_SUBN` +	`STRING` +	`NULL` +
`ELT_SUBN_TEMP` +	`TEMP` +	`REC_SUBN` +	`STRING` +	`NULL` +
`ELT_SUBN_ANCE` +	`ANCE` +	`REC_SUBN` +	`STRING` +	`NULL` +
`ELT_SUBN_DESC` +	`DESC` +	`REC_SUBN` +	`STRING` +	`NULL` +
`ELT_SUBN_ORDI` +	`ORDI` +	`REC_SUBN` +	`STRING` +	`NULL` +
`ELT_SUBN_RIN` +	`RIN` +	`REC_SUBN` +	`STRING` +	`NULL` +
`ELT_SUBM_NAME` +	`NAME` +	`REC_SUBM` +	`STRING` +	`NULL` +
`ELT_SUBM_LANG` +	`LANG` +	`REC_SUBM` +	`STRING` +	`NULL` +
`ELT_SUBM_RFN` +	`RFN` +	`REC_SUBM` +	`STRING` +	`NULL` +
`ELT_SUBM_RIN` +	`RIN` +	`REC_SUBM` +	`STRING` +	`NULL` +
`ELT_SUB_ADDR` +	`ADDR` +	`ELT_HEAD_SOUR_CORP, + REC_REPO, REC_SUBM, +ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, +ELT_SUB_INDIV_EVEN` +	`STRING` +	`STRING` +
`ELT_SUB_ADDR_CONT` +	`CONT` +	`ELT_SUB_ADDR` +	`STRING` +	`NULL` +
`ELT_SUB_ADDR_ADR1` +	`ADR1` +	`ELT_SUB_ADDR` +	`STRING` +	`NULL` +
`ELT_SUB_ADDR_ADR2` +	`ADR2` +	`ELT_SUB_ADDR` +	`STRING` +	`NULL` +
`ELT_SUB_ADDR_CITY` +	`CITY` +	`ELT_SUB_ADDR` +	`STRING` +	`NULL` +
`ELT_SUB_ADDR_STAE` +	`STAE` +	`ELT_SUB_ADDR` +	`STRING` +	`NULL` +
`ELT_SUB_ADDR_POST` +	`POST` +	`ELT_SUB_ADDR` +	`STRING` +	`NULL` +
`ELT_SUB_ADDR_CTRY` +	`CTRY` +	`ELT_SUB_ADDR` +	`STRING` +	`NULL` +
`ELT_SUB_PHON` +	`PHON` +	`ELT_HEAD_SOUR_CORP, + REC_REPO, REC_SUBM, +ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, +ELT_SUB_INDIV_EVEN` +	`STRING` +	`NULL` +
`ELT_SUB_ASSO` +	`ASSO` +	`REC_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)` +	`NULL` +
`ELT_SUB_ASSO_TYPE` +	`TYPE` +	`ELT_SUB_ASSO` +	`STRING` +	`NULL` +
`ELT_SUB_ASSO_RELA` +	`RELA` +	`ELT_SUB_ASSO` +	`STRING` +	`NULL` +
`ELT_SUB_CHAN` +	`CHAN` +	`REC_FAM, REC_INDI, + REC_OBJE, REC_NOTE, + REC_REPO, REC_SOUR, + REC_SUBM +` +	`NULL` +	`NULL` +
`ELT_SUB_CHAN_DATE` +	`DATE` +	`ELT_SUB_CHAN` +	`DATE` +	`NULL` +
`ELT_SUB_CHAN_TIME` +	`TIME` +	`ELT_SUB_CHAN_DATE` +	`STRING` +	`NULL` +
`ELT_SUB_FAMC` +	`FAMC` +	`REC_INDI` +	`XREF_PTR(FAM)` +	`NULL` +
`ELT_SUB_FAMC_PEDI` +	`PEDI` +	`ELT_SUB_FAMC` +	`STRING` +	`NULL` +
`ELT_SUB_CONT` +	`CONT` +	`ELT_HEAD_NOTE, REC_NOTE, + ELT_SOUR_AUTH, ELT_SOUR_TITL, + ELT_SOUR_PUBL, ELT_SOUR_TEXT, + ELT_SUB_NOTE, + ELT_SUB_SOUR, ELT_SUB_SOUR_TEXT +` +	`NULL STRING` +	`NULL` +
`ELT_SUB_CONC` +	`CONC` +	`ELT_HEAD_NOTE, REC_NOTE, + ELT_SOUR_AUTH, ELT_SOUR_TITL, + ELT_SOUR_PUBL, ELT_SOUR_TEXT, + ELT_SUB_NOTE, + ELT_SUB_SOUR, ELT_SUB_SOUR_TEXT +` +	`STRING` +	`NULL` +
`ELT_SUB_EVT_TYPE` +	`TYPE` +	`ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, +ELT_SUB_INDIV_EVEN` +	`STRING` +	`NULL` +
`ELT_SUB_EVT_DATE` +	`DATE` +	`ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, +ELT_SUB_INDIV_EVEN` +	`DATE` +	`NULL` +
`ELT_SUB_EVT_AGE` +	`AGE` +	`ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, +ELT_SUB_INDIV_EVEN` +	`AGE` +	`NULL` +
`ELT_SUB_EVT_AGNC` +	`AGNC` +	`ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, +ELT_SUB_INDIV_EVEN` +	`STRING` +	`NULL` +
`ELT_SUB_EVT_CAUS` +	`CAUS` +	`ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, +ELT_SUB_INDIV_EVEN` +	`STRING` +	`NULL` +
`ELT_SUB_FAM_EVT` +	`ANUL, CENS, DIV, + DIVF, ENGA, MARR, + MARB, MARC, MARL, + MARS` +	`REC_FAM` +	`NULL + STRING` +	`NULL` +
`ELT_SUB_FAM_EVT_HUSB` +	`HUSB` +	`ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN` +	`NULL` +	`NULL` +
`ELT_SUB_FAM_EVT_WIFE` +	`WIFE` +	`ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN` +	`NULL` +	`NULL` +
`ELT_SUB_FAM_EVT_AGE` +	`AGE` +	`ELT_SUB_FAM_EVT_HUSB`, + `ELT_SUB_FAM_EVT_WIFE` +	`AGE` +	`NULL` +
`ELT_SUB_FAM_EVT_EVEN` +	`EVEN` +	`REC_FAM` +	`NULL` +	`NULL` +
`ELT_SUB_IDENT_REFN` +	`REFN` +	`REC_FAM, REC_INDI, + REC_OBJE, REC_NOTE, + REC_REPO, REC_SOUR +` +	`STRING` +	`NULL` +
`ELT_SUB_IDENT_REFN_TYPE` +	`TYPE` +	`ELT_SUB_IDENT_REFN` +	`STRING` +	`NULL` +
`ELT_SUB_IDENT_RIN` +	`RIN` +	`REC_FAM, REC_INDI, + REC_OBJE, REC_NOTE, + REC_REPO, REC_SOUR +` +	`STRING` +	`NULL` +
`ELT_SUB_INDIV_ATTR`	Meaning +	`CAST, DSCR, EDUC, + IDNO, NATI, NCHR, + NMR, OCCU, PROP, + RELI, SSN, TITL`	Relevant members +	`REC_INDI`	`STRING` +	`NULL` +
`DV_NO_MODIFIER` +	`ELT_SUB_INDIV_RESI`	just a simple date +	`RESI`	date1 +	`REC_INDI`	`NULL` +	`NULL` +
`DV_BEFORE` +	`ELT_SUB_INDIV_BIRT`	a range (BEFORE date1) +	`BIRT, CHR`	date1 +	`REC_INDI`	`NULL + STRING` +	`NULL` +
`DV_AFTER` +	`ELT_SUB_INDIV_BIRT_FAMC`	a range (AFTER date1) +	`FAMC`	date1 +	`ELT_SUB_INDIV_BIRT`	`XREF_PTR(FAM)` +	`NULL` +
`DV_BETWEEN` +	`ELT_SUB_INDIV_GEN`	a range (BETWEEN date1 AND date2) +	`DEAT, BURI, CREM, + BAPM, BARM, BASM, + BLES, CHRA, CONF, + FCOM, ORDN, NATU, + EMIG, IMMI, CENS, + PROB, WILL, GRAD, + RETI`	date1, date2 +	`REC_INDI`	`NULL + STRING` +	`NULL` +
`DV_FROM` +	`ELT_SUB_INDIV_ADOP`	a period (FROM date1) +	`ADOP`	date1 +	`REC_INDI`	`NULL + STRING` +	`NULL` +
`DV_TO` +	`ELT_SUB_INDIV_ADOP_FAMC`	a period (TO date1) +	`FAMC`	date1 +	`ELT_SUB_INDIV_ADOP`	`XREF_PTR(FAM)` +	`NULL` +
`DV_FROM_TO` +	`ELT_SUB_INDIV_ADOP_FAMC_ADOP`	a period (FROM date1 TO date2) +	`ADOP`	date1, date2 +	`ELT_SUB_INDIV_ADOP_FAMC`	`STRING` +	`NULL` +
`DV_ABOUT` +	`ELT_SUB_INDIV_EVEN`	an approximation (ABOUT date1) +	`EVEN`	date1 +	`REC_INDI`	`NULL` +	`NULL` +
`DV_CALCULATED` +	`ELT_SUB_LIO_BAPL`	an approximation (CALCULATED date1) +	`BAPL, CONL, ENDL`	date1 +	`REC_INDI`	`NULL` +	`NULL` +
`DV_ESTIMATED` +	`ELT_SUB_LIO_BAPL_STAT`	an approximation (ESTIMATED date1) +	`STAT`	date1 +	`ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC +`	`STRING` +	`NULL` +
`DV_INTERPRETED` +	`ELT_SUB_LIO_BAPL_DATE`	INTERPRETED date1 FROM a given free form date -phrase +	`DATE`	date1, phrase +	`ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC +` +	`DATE` +	`NULL` +
`DV_PHRASE` +	`ELT_SUB_LIO_BAPL_TEMP`	a free form date phrase +	`TEMP`	phrase +	`ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC +` +	`STRING` +	`NULL` +

ELT_SUB_LIO_BAPL_PLAC

PLAC

ELT_SUB_LIO_BAPL

,

+     ELT_SUB_LIO_SLGC

+

STRING

NULL

ELT_SUB_LIO_SLGC

SLGC

REC_INDI

NULL

ELT_SUB_LIO_SLGC_FAMC

FAMC

ELT_SUB_LIO_SLGC

XREF_PTR(FAM)

NULL

ELT_SUB_LSS_SLGS

SLGS

REC_FAM

NULL

ELT_SUB_LSS_SLGS_STAT

STAT

ELT_SUB_LSS_SLGS

STRING

NULL

ELT_SUB_LSS_SLGS_DATE

DATE

ELT_SUB_LSS_SLGS

DATE

NULL

ELT_SUB_LSS_SLGS_TEMP

TEMP

ELT_SUB_LSS_SLGS

STRING

NULL

ELT_SUB_LSS_SLGS_PLAC

PLAC

ELT_SUB_LSS_SLGS

STRING

NULL

ELT_SUB_MULTIM_OBJE

OBJE

REC_FAM, REC_INDI,

+    REC_SOUR, REC_SUBM,

+

ELT_SUB_FAM_EVT,

+    ELT_SUB_FAM_EVT_EVEN,

+    ELT_SUB_INDIV_ATTR,

+    ELT_SUB_INDIV_RESI

,

+     ELT_SUB_INDIV_BIRT,

+     ELT_SUB_INDIV_GEN,

+     ELT_SUB_INDIV_ADOP,

+ELT_SUB_INDIV_EVEN,

+    ELT_SUB_SOUR

NULL

+ XREF_PTR(OBJE)

+

NULL

ELT_SUB_MULTIM_OBJE_FORM

FORM

ELT_SUB_MULTIM_OBJE

STRING

NULL

ELT_SUB_MULTIM_OBJE_TITL

TITL

ELT_SUB_MULTIM_OBJE

STRING

NULL

ELT_SUB_MULTIM_OBJE_FILE

FILE

ELT_SUB_MULTIM_OBJE

STRING

NULL

ELT_SUB_NOTE

NOTE

REC_FAM, REC_INDI,

+    REC_OBJE, REC_REPO,

+    REC_SOUR, ELT_SOUR_DATA,

+    ELT_SUB_ASSO, ELT_SUB_CHAN,

+    ELT_SUB_FAMC,

ELT_SUB_FAM_EVT,

+    ELT_SUB_FAM_EVT_EVEN,

+    ELT_SUB_INDIV_ATTR,

+    ELT_SUB_INDIV_RESI

,

+     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,

+    ELT_SUB_MULTIM_OBJE,

+    ELT_SUB_PERS_NAME,

+    ELT_SUB_PLAC,

+    ELT_SUB_SOUR,

+    ELT_SUB_REPO,

+    ELT_SUB_FAMS

NULL

+     STRING

+ XREF_PTR(NOTE)

+

STRING

+      

+NULL

ELT_SUB_PERS_NAME

NAME

REC_INDI

STRING

NULL

ELT_SUB_PERS_NAME_NPFX

NPFX

ELT_SUB_PERS_NAME

STRING

NULL

ELT_SUB_PERS_NAME_GIVN

GIVN

ELT_SUB_PERS_NAME

STRING

NULL

ELT_SUB_PERS_NAME_NICK

NICK

ELT_SUB_PERS_NAME

STRING

NULL

ELT_SUB_PERS_NAME_SPFX

SPFX

ELT_SUB_PERS_NAME

STRING

NULL

ELT_SUB_PERS_NAME_SURN

SURN

ELT_SUB_PERS_NAME

STRING

NULL

ELT_SUB_PERS_NAME_NSFX

NSFX

ELT_SUB_PERS_NAME

STRING

NULL

ELT_SUB_PLAC

PLAC

ELT_SUB_FAM_EVT

ELT_SUB_FAM_EVT_EVEN,

+    ELT_SUB_INDIV_ATTR,

+    ELT_SUB_INDIV_RESI

,
      

+ELT_SUB_INDIV_BIRT,

+     ELT_SUB_INDIV_GEN,

+     ELT_SUB_INDIV_ADOP,

+ELT_SUB_INDIV_EVEN

STRING

NULL

ELT_SUB_PLAC_FORM

FORM

ELT_SUB_PLAC

STRING

NULL

ELT_SUB_SOUR

SOUR

REC_FAM, REC_INDI,

+    REC_NOTE, ELT_SUB_ASSO

+

ELT_SUB_FAM_EVT,

+

ELT_SUB_FAM_EVT_EVEN,

+    ELT_SUB_INDIV_ATTR,

+    ELT_SUB_INDIV_RESI

,

+     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,

+    ELT_SUB_NOTE,

+    ELT_SUB_PERS_NAME,

+    ELT_SUB_PLAC

STRING

+ XREF_PTR(SOUR)

STRING

+NULL

ELT_SUB_SOUR_PAGE

PAGE

ELT_SUB_SOUR

STRING

NULL

ELT_SUB_SOUR_EVEN

EVEN

ELT_SUB_SOUR

STRING

NULL

ELT_SUB_SOUR_EVEN_ROLE

ROLE

ELT_SUB_SOUR_EVEN

STRING

NULL

ELT_SUB_SOUR_DATA

DATA

ELT_SUB_SOUR

NULL

ELT_SUB_SOUR_DATA_DATE

DATE

ELT_SUB_SOUR_DATA

DATE

NULL

ELT_SUB_SOUR_TEXT

TEXT

ELT_SUB_SOUR

+    ELT_SUB_SOUR_DATA

STRING

NULL

ELT_SUB_SOUR_QUAY

QUAY

ELT_SUB_SOUR

STRING

NULL

ELT_SUB_REPO

REPO

REC_SOUR

XREF_PTR(REPO)

NULL

ELT_SUB_REPO_CALN

CALN

ELT_SUB_REPO

STRING

NULL

ELT_SUB_REPO_CALN_MEDI

MEDI

ELT_SUB_REPO_CALN

STRING

NULL

ELT_SUB_FAMS

FAMS

REC_INDI

XREF_PTR(FAM)

NULL

ELT_USER

any tag starting

+     with an underscore

anywhere

NULL

+     STRING

+ XREF_PTR(USER)

NULL

struct date
-

date1

date2

struct date { - Calendar_type cal; - char day_str[MAX_DAY_LEN + 1]; - char month_str[MAX_MONTH_LEN -+ 1]; - char year_str[MAX_YEAR_LEN + -1]; + +Gedcom_val types + + Currently, the specific Gedcom_val types are (with + val of type Gedcom_val): + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + type checker + cast operator + null value + GEDCOM_IS_NULL(val) + N/A + string + GEDCOM_IS_STRING(val) + char* str = GEDCOM_STRING(val); + date + GEDCOM_IS_DATE(val) + struct date_value dv = GEDCOM_DATE(val); age + GEDCOM_IS_AGE(val) + struct age_value age = GEDCOM_AGE(val); + xref pointer + GEDCOM_IS_XREF_PTR(val) + struct xref_value *xr = GEDCOM_XREF_PTR(val); + + + + The type checker returns a true or a false value according to the +type of the value, but this is in principle only necessary in the rare +circumstances that two types are possible, or where an optional value +can be provided. In most cases, the type is fixed for a specific +tag. + + The null value is used for when the GEDCOM spec doesn't allow a value, + or when an optional value is allowed but none is given. + + The string value is the most general used value currently, for all +those values that don't have a more specific meaning. In essence, +the value that is returned by GEDCOM_STRING(val) is always the same as the +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. + + The xref value is for cross-references between records in the file. See +here for the definition. + + +struct date_value + This struct describes a date as given in the GEDCOM file, and has the + following definition: + +struct date_value { + Date_value_type type; + struct date date1; + struct date date2; + char phrase[MAX_PHRASE_LEN + + 1]; + }; + + It depends on the first member, the type, which members are actually + relevant: - int day; - int month; - int year; - Year_type year_type; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Date_value_type + Meaning + Relevant members + DV_NO_MODIFIER + just a simple date + date1 + DV_BEFORE + a range (BEFORE date1) + date1 + DV_AFTER + a range (AFTER date1) + date1 + DV_BETWEEN + a range (BETWEEN date1 AND date2) + date1, date2 + DV_FROM + a period (FROM date1) + date1 + DV_TO + a period (TO date1) + date1 + DV_FROM_TO + a period (FROM date1 TO date2) + date1, date2 + DV_ABOUT + an approximation (ABOUT date1) + date1 + DV_CALCULATED + an approximation (CALCULATED date1) + date1 + DV_ESTIMATED + an approximation (ESTIMATED date1) + date1 + DV_INTERPRETED + INTERPRETED date1 FROM a given free form date + phrase + date1, phrase + DV_PHRASE + a free form date phrase + phrase + - Date_type type; - long int sdn1; - long int sdn2; - };
-

day_str

month_str

year_str

day_str

month_str

cal

LINK TBD

date_value

struct date_value* gedcom_new_date_value (struct date_value* copy_from);

copy_from

NULL

struct date
+

date1

date2

struct date { + Calendar_type cal; + char day_str[MAX_DAY_LEN + +1]; + char month_str[MAX_MONTH_LEN + + 1]; + char year_str[MAX_YEAR_LEN ++ 1]; + + int day; + int month; + int year; + Year_type year_type; + + Date_type type; + long int sdn1; + long int sdn2; + };
+

day_str

month_str

year_str

day_str

month_str

cal

LINK TBD

CAL_GREGORIAN : the Gregorian calendar
CAL_JULIAN : the Julian calendar
CAL_HEBREW : the Hebrew (Jewish) calendar
CAL_FRENCH_REV : the calendar used after the French - Revolution
CAL_UNKNOWN : an unknown calendar type
CAL_GREGORIAN : the Gregorian calendar
CAL_JULIAN : the Julian calendar
CAL_HEBREW : the Hebrew (Jewish) calendar
CAL_FRENCH_REV : the calendar used after the +French Revolution
CAL_UNKNOWN : an unknown calendar type

the day is just the numeric representation of the - day_str (starting from 1), -1 if the day_str - is empty
the month is the month number of month_str - in the given calendar type (also starting from 1), -1 if the month_str - is empty
the year is the numeric representation of the - year_str
the day is just the numeric representation of +the day_str (starting from 1), -1 if the day_str + is empty
the month is the month number of month_str + in the given calendar type (also starting from 1), -1 if the +month_str is empty
the year is the numeric representation of the + year_str

year_str

LINK TBD

year

year_type

YEAR_DOUBLE.

year_type


-YEAR_SINGLE

year_str

LINK TBD

year

year_type

YEAR_DOUBLE.

year_type


+  YEAR_SINGLE

Exact dates (e.g. "25 MAR 1990"):
Exact dates (e.g. "25 MAR 1990"):

-
These are represented by a serial day number in sdn1 - and a Date_type equal to DATE_EXACT.
-
-

+
These are represented by a serial day number in sdn1 + and a Date_type equal to DATE_EXACT.
+
+

Incomplete dates (e.g. "MAR 1990"):
Incomplete dates (e.g. "MAR 1990"):

-
These are represented by 2 serial day numbers (- sdn1 and sdn2) and a Date_type equal to - DATE_BOUNDED.
-
- For example, the Gregorian date "MAR 1990" is represented by the serial - day numbers for "1 MAR 1990" and "31 MAR 1990", and the Gregorian date "1990" - is represented by the serial day numbers for "1 JAN 1990" and "31 DEC 1990". - Similarly for the other calendar types.
-
+ +
+ + +
These are represented by 2 serial day numbers (sdn1 and sdn2) and a Date_type equal +to DATE_BOUNDED.
+
+ + For example, the Gregorian date "MAR 1990" is represented by the serial + day numbers for "1 MAR 1990" and "31 MAR 1990", and the Gregorian date +"1990" is represented by the serial day numbers for "1 JAN 1990" and "31 +DEC 1990". Similarly for the other calendar types.
+
+
+
+ +
+To ensure that an updated date value is consistent, i.e. all +its struct fields are consistent with each other, the following function +can be used:
+
int gedcom_normalize_date (Date_input compute_from, struct date_value* value);
+ +The compute_from parameter determines which fields +will be taken as input to compute the other fields. The following table +gives an overview of the input and output parameters (the calendar type cal is always an input parameter, and should not be CAL_UNKNOWN):
+
+ + + + + + + + + + + + + + + + + + + + + + + +
compute_from
+ input parameters
+ output parameters
+
DI_FROM_STRINGS
+ day_str, month_str, year_str
+ day, month, year, year_type +type, sdn1, sdn2
+
DI_FROM_NUMBERS
+ day, month, year, year_type
+ day_str, month_str, year_str + +type, sdn1, sdn2
+
DI_FROM_SDN
+ type, sdn1, sdn2
+ day, month, year +day_str, month_str, year_str
+
+
+If the type in the date value is DV_PHRASE, no conversions take +place, otherwise one or both of the date structs are processed according +to the table above, depending on the type. The function returns 0 in case of success, non-zero in case of an error.
+
+This function could also be used to convert a date from one calendar to another, +because the serial day number is calendar independent (error handling is +ignored in this example):
+
struct date_value* dv = gedcom_new_date_value(NULL); +dv->date1.cal = CAL_GREGORIAN; +dv->date1.day = 4;
+ dv->date1.month = 2; +dv->date1.year = 1799; +dv->date1.year_type = YEAR_SINGLE; +gedcom_normalize_date(DI_FROM_NUMBERS, dv); + +dv->date1.cal = CAL_FRENCH_REV; +gedcom_normalize_date(DI_FROM_SDN, dv); +/* the day, month and year are now filled in according to the French Revolution calendar */
+
+ +
+
+ + +
struct age_value
+ + This struct describes an age as given in the GEDCOM file, and has the + following definition:
+ + +
struct age_value { + Age_type type; + Age_modifier mod; + int years; + int months; + int days; + char phrase[MAX_PHRASE_LEN + + 1]; + };
+
+
+
+ + + + It depends on the first member, the type, which members are actually + relevant:
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Age_type
+ Meaning
+ Relevant members
+
AGE_UNRECOGNIZED
+ format not recognized, full raw value in phrase
+ phrase
+
AGE_CHILD
+ the indication 'CHILD'
+ mod
+
AGE_INFANT
+ the indication 'INFANT'
+ mod
+
AGE_STILLBORN
+ the indication 'STILLBORN'
+ mod
+
AGE_NUMERIC
+ an indication in years, months and/or days (each can be -1 if not given)
+ mod, years, months, days
+
+
+The modifier can be one of the following:
+
+
AGE_NO_MODIFIER : no modifier
AGE_LESS_THAN : the modifier '<' is added
AGE_GREATER_THAN : the modifier '>' is added
+
+The following function creates a new age_value struct and initializes it properly, or copies an existing age value: +
struct age_value* gedcom_new_age_value (struct age_value* copy_from);
+ +If the parameter copy_from is NULL, a new value is created and given initial values. If it is non-NULL, the value is copied into a new age 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 +itself). It is defined as:
+ +
struct xref_value { + Xref_type type, + char* string, + Gedcom_ctxt object + };

+ The Xref_type gives the type of the cross-reference and can +be one of:
+ +
+
XREF_NONE (used as default value)
+
XREF_FAM
+
XREF_INDI
+
XREF_NOTE
+
XREF_OBJE
+
XREF_REPO
+
XREF_SOUR
+
XREF_SUBM
+
XREF_SUBN
XREF_ANY (if the type is not known, see below)
+
+ +
XREF_USER (for application-specific cross-references)
+
+ +
+ The string gives the actual cross-reference string from the +GEDCOM file, and the object is initially NULL, but +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.

- -
-
$Id$
$Name$
+ 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 +defined are used (if not, a warning is produced). It also checks whether +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.
+
+The following functions are available to manipulate xref_value objects:
+
struct xref_value* gedcom_get_by_xref (const char *key)
+
Retrieve an xref_value by its key. Returns NULL if the given key isn't a valid cross-reference key (see below) or isn't used.
+
+ struct xref_value* gedcom_add_xref (Xref_type type, const char* key, Gedcom_ctxt object)
+
Add an xref_value of the given type (see list above), with the given key, to the given object, with a use count equal to 0. Returns the new xref_value if success. Returns NULL in one of the following cases:
+
+
the key isn't a valid cross-reference key (see below)
+
there is already an xref_value with the same key
+
there was a memory allocation error
+
+
+ int gedcom_delete_xref (const char* key) + +
Delete the xref_value corresponding to the given key. Returns 0 if success. Returns 1 in one of the following cases:
+
+
the key isn't a valid cross-reference key (see below)
+
there is no xref_value with the given key
+
the xref_value is still in use, i.e. its use count is not 0 (see gedcom_link_xref and gedcom_unlink_xref below)
+
+
+ struct xref_value* gedcom_link_xref (Xref_type type, const char* key) +struct xref_value* gedcom_unlink_xref (Xref_type type, const char* key)
+
Declare +the xref_value corresponding to the given key as being used/no longer used +(linked to or unlinked) as the given type. The use of these functions +is not mandatory, but it can aid in spotting places in the code where xref_value +objects are deleted while they are still referenced.

- - - +Returns the xref_value object if success, and its use count is incremented/decremented. Returns NULL in one of the following cases:
+
+
the key isn't a valid cross-reference key (see below)
+
there is no xref_value with the given key
+
the xref_value was previously added as another type than the type provided here
+
+
+
+
+
+
+ +A cross-reference key must be a string of maximum 22 characters, of the following format:
+
+
an at sign ('@')
+
followed by an alphanumeric character (A-Z, a-z, 0-9 or underscore)
+
followed by zero or more characters, which can be any character except an at sign
+
terminated by an at sign ('@')
+
+An example would thus be: "@This is an xref_val@".
+ + +
+
$Id$
$Name$
+
+ +
+
+
+
+
+
+
+

+	type checker +	cast operator +
null value +	`GEDCOM_IS_NULL(val)` +	N/A +
string +	`GEDCOM_IS_STRING(val)` +	`char* str = GEDCOM_STRING(val);` +
date +	`GEDCOM_IS_DATE(val)` +	`struct date_value dv = GEDCOM_DATE(val);`
age +	`GEDCOM_IS_AGE(val)` +	`struct age_value age = GEDCOM_AGE(val);` +
xref pointer +	`GEDCOM_IS_XREF_PTR(val)` +	`struct xref_value *xr = GEDCOM_XREF_PTR(val);` +

compute_from +	input parameters +	output parameters +
`DI_FROM_STRINGS` +	`day_str, month_str, year_str` +	`day, month, year, year_type +type, sdn1, sdn2` +
`DI_FROM_NUMBERS` +	`day, month, year, year_type` +	`day_str, month_str, year_str + +type, sdn1, sdn2` +
`DI_FROM_SDN` +	`type, sdn1, sdn2` +	`day, month, year +day_str, month_str, year_str` +

Age_type +	Meaning +	Relevant members +
`AGE_UNRECOGNIZED` +	format not recognized, full raw value in phrase +	phrase +
`AGE_CHILD` +	the indication 'CHILD' +	mod +
`AGE_INFANT` +	the indication 'INFANT' +	mod +
`AGE_STILLBORN` +	the indication 'STILLBORN' +	mod +
`AGE_NUMERIC` +	an indication in years, months and/or days (each can be -1 if not given) +	mod, years, months, days +

Libgedcom interface details

Index

Record identifiers

Element identifiers

Gedcom_val types -

struct date_value

Element identifiers

struct date -

Gedcom_val types +

struct date_value

struct date +

struct age_value

struct xref_value

Gedcom_val types
-

struct date
-

Gedcom_val types
+

struct date
+