X-Git-Url: https://git.dlugolecki.net.pl/?a=blobdiff_plain;f=include%2Fgedcom.h.in;h=7625ef4075f68515e687f384b85c7bb25a8ff00b;hb=a32bee3a7c3792af75f2772dd6501fb9429ca749;hp=6482c97edfe337a568e4b7c6143949c492faa431;hpb=0dfc7e7f21a7dcb0087b7ddebae1cc36768f3851;p=gedcom-parse.git diff --git a/include/gedcom.h.in b/include/gedcom.h.in index 6482c97..7625ef4 100644 --- a/include/gedcom.h.in +++ b/include/gedcom.h.in @@ -27,7 +27,9 @@ #include #include -__BEGIN_DECLS +#ifdef __cplusplus +extern "C" { +#endif #ifndef GEDCOM_INTERNAL #include @@ -35,9 +37,12 @@ __BEGIN_DECLS #define GEDCOM_PARSE_VERSION_MAJOR @VERSION_MAJOR@ #define GEDCOM_PARSE_VERSION_MINOR @VERSION_MINOR@ +#define GEDCOM_PARSE_VERSION_PATCH @VERSION_PATCH@ #define GEDCOM_PARSE_VERSION \ (GEDCOM_PARSE_VERSION_MAJOR * 1000 + GEDCOM_PARSE_VERSION_MINOR) +int gedcom_check_version(int major, int minor, int patch); + /**************************************************************************/ /*** First the records and elements to subscribe upon ***/ /**************************************************************************/ @@ -57,7 +62,7 @@ typedef enum _REC { } Gedcom_rec; typedef enum _ELT { - ELT_HEAD_SOUR = NR_OF_RECS + 1, + ELT_HEAD_SOUR = NR_OF_RECS, ELT_HEAD_SOUR_VERS, ELT_HEAD_SOUR_NAME, ELT_HEAD_SOUR_CORP, @@ -362,6 +367,30 @@ struct age_value { char phrase[MAX_PHRASE_LEN + 1]; }; +typedef enum _ENC { + ONE_BYTE = 0x00, + TWO_BYTE_HILO = 0x01, + TWO_BYTE_LOHI = 0x02 +} Encoding; + +typedef enum _ENC_BOM { + WITHOUT_BOM = 0x00, + WITH_BOM = 0x10 +} Enc_bom; + +typedef enum _ENC_LINE_END { + END_CR = 0, + END_LF = 1, + END_CR_LF = 2, + END_LF_CR = 3 +} Enc_line_end; + +typedef enum _DATE_INPUT { + DI_FROM_STRINGS, + DI_FROM_NUMBERS, + DI_FROM_SDN +} Date_input; + /**************************************************************************/ /*** Things meant to be internal, susceptible to changes ***/ /*** Use the GEDCOM_STRING/GEDCOM_DATE interface instead of relying ***/ @@ -369,11 +398,11 @@ struct age_value { /**************************************************************************/ typedef enum _GEDCOM_VAL_TYPE { - GV_NULL, - GV_CHAR_PTR, - GV_DATE_VALUE, - GV_AGE_VALUE, - GV_XREF_PTR + GV_NULL = 0x01, + GV_CHAR_PTR = 0x02, + GV_DATE_VALUE = 0x04, + GV_AGE_VALUE = 0x08, + GV_XREF_PTR = 0x10 } Gedcom_val_type; union _Gedcom_val_union { @@ -411,6 +440,10 @@ extern struct xref_value def_xref_val; /* Type for parsed values, meant to be opaque */ typedef Gedcom_val_struct* Gedcom_val; +/* Type for write handle, meant to be opaque */ +struct Gedcom_write_struct; +typedef struct Gedcom_write_struct* Gedcom_write_hndl; + /* Check to determine whether there is a parsed value or not */ #define GEDCOM_IS_NULL(VAL) \ GV_IS_TYPE(VAL, GV_NULL) @@ -453,7 +486,7 @@ typedef Gedcom_ctxt char *raw_value, int tag_value, Gedcom_val parsed_value); typedef void (*Gedcom_rec_end_cb) - (Gedcom_rec rec, Gedcom_ctxt self); + (Gedcom_rec rec, Gedcom_ctxt self, Gedcom_val parsed_value); typedef Gedcom_ctxt (*Gedcom_elt_start_cb) @@ -470,7 +503,7 @@ typedef void (Gedcom_elt elt, Gedcom_ctxt parent, int level, char *tag, char *raw_value, int tag_value); -void gedcom_init(); +int gedcom_init(); int gedcom_parse_file(const char* file_name); int gedcom_new_model(); void gedcom_set_debug_level(int level, FILE* trace_output); @@ -487,8 +520,14 @@ void gedcom_subscribe_to_element(Gedcom_elt elt, Gedcom_elt_end_cb cb_end); /* Separate value parsing functions */ -struct date_value gedcom_parse_date(const char* line_value); +struct date_value gedcom_parse_date(const char* line_value); +char* gedcom_date_to_string(struct date_value* val); +struct date_value* gedcom_new_date_value(struct date_value* copy_from); +int gedcom_normalize_date(Date_input compute_from, struct date_value *val); + struct age_value gedcom_parse_age(const char* line_value); +struct age_value* gedcom_new_age_value(struct age_value* copy_from); +char* gedcom_age_to_string(struct age_value* val); /* Handling cross-references */ struct xref_value *gedcom_get_by_xref(const char *key); @@ -498,12 +537,43 @@ struct xref_value *gedcom_link_xref(Xref_type type, const char* xrefstr); struct xref_value *gedcom_unlink_xref(Xref_type type, const char* xrefstr); int gedcom_delete_xref(const char* xrefstr); +/* Writing support */ +Gedcom_write_hndl gedcom_write_open(const char* filename); +int gedcom_write_close(Gedcom_write_hndl hndl, int *total_conv_fails); +int gedcom_write_set_encoding(const char* charset, Encoding width, + Enc_bom bom); +int gedcom_write_set_line_terminator(Enc_line_end end); + +int gedcom_write_record_str(Gedcom_write_hndl hndl, + Gedcom_rec rec, char* xrefstr, char* val); + +int gedcom_write_element_str(Gedcom_write_hndl hndl, Gedcom_elt elt, + int parsed_tag, int parent_rec_or_elt, + char* val); +int gedcom_write_element_xref(Gedcom_write_hndl hndl, Gedcom_elt elt, + int parsed_tag, int parent_rec_or_elt, + struct xref_value* val); + +int gedcom_write_element_date(Gedcom_write_hndl hndl, + Gedcom_elt elt, int tag, int parent_rec_or_elt, + struct date_value* val); +int gedcom_write_element_age(Gedcom_write_hndl hndl, + Gedcom_elt elt, int tag, int parent_rec_or_elt, + struct age_value* val); + +int gedcom_write_user_str(Gedcom_write_hndl hndl, int level, char* tag, + char* xrefstr, char* value); +int gedcom_write_user_xref(Gedcom_write_hndl hndl, int level, char* tag, + char* xrefstr, struct xref_value* val); + /* For use in gom */ int gedcom_error(const char* s, ...); int gedcom_warning(const char* s, ...); int gedcom_message(const char* s, ...); int gedcom_debug_print(const char* s, ...); -__END_DECLS +#ifdef __cplusplus +} +#endif #endif /* __GEDCOM_H */