index 230c1c9f887cd434b7c34bd74edf72ec12b88a5d..879af9087db92d7346fee2109326df55eaf25dfc 100644 (file)
--- a/src/include/core/data.h
+++ b/src/include/core/data.h
/*
* SysDB - src/include/core/data.h
/*
* SysDB - src/include/core/data.h
- * Copyright (C) 2012 Sebastian 'tokkee' Harl <sh@tokkee.org>
+ * Copyright (C) 2012-2014 Sebastian 'tokkee' Harl <sh@tokkee.org>
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
/*
* sdb_data_free_datum:
* Free any dynamic memory referenced by the specified datum. Does not free
/*
* sdb_data_free_datum:
* Free any dynamic memory referenced by the specified datum. Does not free
- * the memory allocated for the sdb_data_t object itself. This function must
+ * the memory allocated by the sdb_data_t object itself. This function must
* not be used if any static or stack memory is referenced from the data
* object.
*/
void
sdb_data_free_datum(sdb_data_t *datum);
* not be used if any static or stack memory is referenced from the data
* object.
*/
void
sdb_data_free_datum(sdb_data_t *datum);
+/*
+ * sdb_data_cmp:
+ * Compare two data points. A NULL datum is considered less than any non-NULL
+ * datum. On data-type mismatch, the function always returns a negative value.
+ *
+ * Returns:
+ * - a value less than zero if d1 compares less than d2
+ * - zero if d1 compares equal to d2
+ * - a value greater than zero if d1 compares greater than d2
+ */
+int
+sdb_data_cmp(sdb_data_t *d1, sdb_data_t *d2);
+
/*
* sdb_data_strlen:
* Returns a (worst-case) estimate for the number of bytes required to format
/*
* sdb_data_strlen:
* Returns a (worst-case) estimate for the number of bytes required to format
* account.
*/
size_t
* account.
*/
size_t
-sdb_data_strlen(sdb_data_t *datum);
+sdb_data_strlen(const sdb_data_t *datum);
+
+enum {
+ SDB_UNQUOTED = 0,
+ SDB_SINGLE_QUOTED,
+ SDB_DOUBLE_QUOTED,
+};
/*
* sdb_data_format:
* Output the specified datum to the specified string using a default format.
/*
* sdb_data_format:
* Output the specified datum to the specified string using a default format.
- * If the buffer size is less than the return value of sdb_data_strlen, the
- * datum may be truncated. The buffer will always be nul-terminated after
- * calling this function.
+ * The value of 'quoted' determines whether and how non-integer and
+ * non-decimal values are quoted. If the buffer size is less than the return
+ * value of sdb_data_strlen, the datum may be truncated. The buffer will
+ * always be nul-terminated after calling this function.
*
* Returns:
* - the number of characters written to the buffer (excluding the terminated
*
* Returns:
* - the number of characters written to the buffer (excluding the terminated
* - a negative value else
*/
int
* - a negative value else
*/
int
-sdb_data_format(sdb_data_t *datum, char *buf, size_t buflen);
+sdb_data_format(const sdb_data_t *datum, char *buf, size_t buflen, int quoted);
#ifdef __cplusplus
} /* extern "C" */
#ifdef __cplusplus
} /* extern "C" */