[glib: 2/5] Add gvdb_table_is_valid() API

[Ryan Lortie <ryanl src gnome org>]

commit df40747190a0fff4582c84b101f74e5da91f8f72
Author: Ryan Lortie <desrt desrt ca>
Date:   Sun Jul 18 20:45:37 2010 -0400

    Add gvdb_table_is_valid() API
    
    Checks that the on-disk file is still valid.

 gvdb-reader.c |   17 +++++++++++++++++
 gvdb-reader.h |    3 +++
 2 files changed, 20 insertions(+), 0 deletions(-)
---
diff --git a/gvdb-reader.c b/gvdb-reader.c
index a043060..01ef756 100644
--- a/gvdb-reader.c
+++ b/gvdb-reader.c
@@ -534,6 +534,23 @@ gvdb_table_unref (GvdbTable *file)
     }
 }
 
+/**
+ * gvdb_table_is_valid:
+ * @table: a #GvdbTable
+ * @returns: %TRUE if @table is still valid
+ *
+ * Checks if the table is still valid.
+ *
+ * An on-disk GVDB can be marked as invalid.  This happens when the file
+ * has been replaced.  The appropriate action is typically to reopen the
+ * file.
+ **/
+gboolean
+gvdb_table_is_valid (GvdbTable *table)
+{
+  return !!table->data;
+}
+
 void
 gvdb_table_walk (GvdbTable         *table,
                  const gchar       *key,
diff --git a/gvdb-reader.h b/gvdb-reader.h
index a29c16e..c960646 100644
--- a/gvdb-reader.h
+++ b/gvdb-reader.h
@@ -49,6 +49,9 @@ G_GNUC_INTERNAL
 gboolean                gvdb_table_has_value                            (GvdbTable    *table,
                                                                          const gchar  *key);
 
+G_GNUC_INTERNAL
+gboolean                gvdb_table_is_valid                             (GvdbTable    *table);
+
 typedef void          (*GvdbWalkValueFunc)                              (const gchar       *name,
                                                                          gsize              name_len,
                                                                          GVariant          *value,