Libgedcom interface details


Index



Record identifiers

The following table describes the identifiers to be used in the record callbacks.  The last columns give the Gedcom_val type of the xref and  val arguments in the record start and end callback.

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

Element identifiers

The following table describes the identifiers to be used in the element callbacks.  The last columns give the Gedcom_val type of the val argument in the element start and end callback.

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
CAST, DSCR, EDUC,
IDNO, NATI, NCHR,
NMR, OCCU, PROP,
RELI, SSN, TITL

REC_INDI
STRING
NULL
ELT_SUB_INDIV_RESI
RESI
REC_INDI
NULL
NULL
ELT_SUB_INDIV_BIRT
BIRT, CHR
REC_INDI
NULL
STRING

NULL
ELT_SUB_INDIV_BIRT_FAMC
FAMC
ELT_SUB_INDIV_BIRT
XREF_PTR(FAM)
NULL
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

NULL
ELT_SUB_INDIV_ADOP
ADOP
REC_INDI
NULL
STRING

NULL
ELT_SUB_INDIV_ADOP_FAMC
FAMC
ELT_SUB_INDIV_ADOP
XREF_PTR(FAM)
NULL
ELT_SUB_INDIV_ADOP_FAMC_ADOP
ADOP
ELT_SUB_INDIV_ADOP_FAMC
STRING
NULL
ELT_SUB_INDIV_EVEN
EVEN
REC_INDI
NULL
NULL
ELT_SUB_LIO_BAPL
BAPL, CONL, ENDL
REC_INDI
NULL
NULL
ELT_SUB_LIO_BAPL_STAT
STAT
ELT_SUB_LIO_BAPL,
ELT_SUB_LIO_SLGC

STRING
NULL
ELT_SUB_LIO_BAPL_DATE
DATE
ELT_SUB_LIO_BAPL,
ELT_SUB_LIO_SLGC


DATE
NULL
ELT_SUB_LIO_BAPL_TEMP
TEMP
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
NULL
ELT_SUB_LIO_SLGC_FAMC
FAMC
ELT_SUB_LIO_SLGC
XREF_PTR(FAM)
NULL
ELT_SUB_LSS_SLGS
SLGS
REC_FAM
NULL
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
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

$Id$
$Name$