Add afc_get_device_info_field() helper function

For use in front-end applications, also serves to document
the available keys.

2 files changed, 32 insertions, 0 deletions

diff --git a/include/libiphone/afc.h b/include/libiphone/afc.h
index 651621e..77b6f0e 100644
--- a/include/libiphone/afc.h
+++ b/include/libiphone/afc.h
@@ -106,6 +106,9 @@ afc_error_t afc_make_directory(afc_client_t client, const char *dir);
 afc_error_t afc_truncate(afc_client_t client, const char *path, off_t newsize);
 afc_error_t afc_make_link(afc_client_t client, afc_link_type_t linktype, const char *target, const char *linkname);
 
+/* Helper functions */
+char *      afc_get_device_info_field(afc_client_t client, const char *field);
+
 #ifdef __cplusplus
 }
 #endif
diff --git a/src/AFC.c b/src/AFC.c
index 826c9e5..d2761cf 100644
--- a/src/AFC.c
+++ b/src/AFC.c
@@ -468,6 +468,35 @@ afc_error_t afc_get_device_info(afc_client_t client, char ***infos)
         return ret;
 }
 
+/** Get a specific field of the device info for a client connection to phone.
+ * Known values are: Model, FSTotalBytes, FSFreeBytes and FSBlockSize. This is
+ * a helper function for afc_get_device_info().
+ *
+ * @param client The client to get device info for.
+ * @param field The field to get the information for
+ *
+ * @return A char * or NULL if there was an error.
+ */
+char * afc_get_device_info_field(afc_client_t client, const char *field)
+{
+        char *ret = NULL;
+        char **kvps, **ptr;
+
+        if (field == NULL || afc_get_device_info(client, &kvps) != AFC_E_SUCCESS)
+                return NULL;
+
+        for (ptr = kvps; *ptr; ptr++) {
+                if (!strcmp(*ptr, field)) {
+                        ret = strdup(*(ptr+1));
+                        break;
+                }
+        }
+
+        g_strfreev(kvps);
+
+        return ret;
+}
+
 /** Deletes a file or directory.
  * 
  * @param client The client to use.