#ifndef _LSUP_TERM_H #define _LSUP_TERM_H #include #include #include "buffer.h" #include "namespace.h" #define LANG_SIZE 8 // Size in chars of lang tag // "NULL" triple, a value that is never user-provided. Used to fill deleted // triples in a keyset. #define NULL_TRP {NULL_KEY, NULL_KEY, NULL_KEY} #define UUID4_URN_SIZE UUIDSTR_SIZE + 10 typedef XXH64_hash_t LSUP_TermHash64; typedef char langtag[LANG_SIZE]; typedef char LSUP_term_type; #define LSUP_TERM_UNDEFINED 0 #define LSUP_TERM_URI 1 #define LSUP_TERM_BNODE 2 #define LSUP_TERM_LITERAL 3 /** @brief Default data type for untyped literals. */ #define DEFAULT_DTYPE "http://www.w3.org/2001/XMLSchema#string" typedef struct term_t { char * data; // URI or literal value, or BNode label. char * datatype; // Data type for literals. // This language variable currently supports a 2-digit ISO 639 language union { langtag lang; // Language tag. This variable currently // supports a 2-digit ISO 639 language // code and a 2-character ISO 3166-1 // country code, separated by a hyphen. See // https://tools.ietf.org/html/bcp47#section-2.1 uint64_t bnode_id; // Blank node ID. TODO implement. }; LSUP_term_type type; // Term type. } LSUP_Term; /** @brief Create a new term. * * @param type[in] Term type. One of #LSUP_term_type. * * @param data[in] Term data: textual URI, literal value without data type * or langtag, etc. * * @param datatype[in]: data type for literals. * * @param lang[in]: language tag for string literals. * * @param term[out] Pointer to a new term, which must be freed with * #LSUP_term_free after use. * * @return LSUP_OK if successful, LSUP_VALUE_ERR if validation fails. */ LSUP_Term * LSUP_term_new( LSUP_term_type type, const char *data, char *datatype, char *lang); /** @brief Placeholder term to use with LSUP_term_reset. */ #define TERM_DUMMY LSUP_term_new (LSUP_TERM_UNDEFINED, NULL, NULL, NULL) /** @brief Shortcut to create a URI. * * Must be freed with #LSUP_term_free. * * @param data[in] The URI string. If NULL, a UUID4-based URN is generated. * * @param uri[out] The URI to be created. * * @return LSUP_OK if successful, LSUP_VALUE_ERR if validation fails. */ inline LSUP_Term * LSUP_uri_new (const char *data) { if (!data) { uuid_t uuid; uuid_generate_random (uuid); uuid_str_t uuid_str; uuid_unparse_lower (uuid, uuid_str); char uri[UUID4_URN_SIZE]; snprintf (uri, UUID4_URN_SIZE, "urn:uuid4:%s", uuid_str); data = uri; } return LSUP_term_new (LSUP_TERM_URI, data, NULL, NULL); } /* @brief Reuse a pre-allocated term structure. * * The structure must have been previously created with #LSUP_term_new. It can * be reinitialized multiple times without freeing it. It must be eventually * freed with #LSUP_term_free. */ LSUP_rc LSUP_term_init( LSUP_Term *term, LSUP_term_type type, const char *data, char *datatype, char *lang); LSUP_Term * LSUP_term_new_from_buffer (const LSUP_Buffer *sterm); LSUP_Buffer * LSUP_buffer_new_from_term (const LSUP_Term *term); /** * @brief Shortcut to initialize a URI. */ inline LSUP_rc LSUP_uri_init (LSUP_Term *term, const char *data) { if (!data) { uuid_t uuid; uuid_generate_random (uuid); uuid_str_t uuid_str; uuid_unparse_lower (uuid, uuid_str); char uri[UUIDSTR_SIZE + 10]; sprintf (uri, "urn:uuid4:%s", uuid_str); data = uri; } return LSUP_term_init (term, LSUP_TERM_URI, data, NULL, NULL); } /** @brief Simple ad-hoc serialization function. * * The resulting term must be freed with #LSUP_term_free after use. */ LSUP_rc LSUP_term_serialize (const LSUP_Term *term, LSUP_Buffer *sterm); /** @brief Deserialize a buffer into a term. * * The buffer must be a well-formed serialization of a term, e.g. as obtained * by #LSUP_term_serialize. */ LSUP_rc LSUP_term_deserialize (const LSUP_Buffer *sterm, LSUP_Term *term); /** @brief Hash a buffer. */ inline LSUP_Key LSUP_term_hash (const LSUP_Term *term) { LSUP_Buffer *buf; if (UNLIKELY (!term)) buf = BUF_DUMMY; else buf = LSUP_buffer_new_from_term (term); LSUP_Key key = LSUP_buffer_hash (buf); LSUP_buffer_free (buf); return key; } /** * Compare two terms. */ bool LSUP_term_equals (const LSUP_Term *term1, const LSUP_Term *term2); /* // TODO Implement when xxhash v0.8 is released with stable xxhash128 function. inline XXH128_hash_t LSUP_term_hash128(const LSUP_Term *term); */ void LSUP_term_done (LSUP_Term *term); void LSUP_term_free (LSUP_Term *term); #endif