Mercurial > pidgin3 / file diff

--- a/libpurple/request.h	Sun Jul 29 13:06:47 2012 +0200
+++ b/libpurple/request.h	Sat Aug 04 08:52:12 2012 +0200
@@ -150,7 +150,8 @@
 
 typedef void (*PurpleRequestInputCb)(void *, const char *);
 
-typedef gboolean (*PurpleRequestFieldValidator)(PurpleRequestField *field, void *user_data);
+typedef gboolean (*PurpleRequestFieldValidator)(PurpleRequestField *field,
+	gchar **errmsg, void *user_data);
 
 /** The type of callbacks passed to purple_request_action().  The first
  *  argument is the @a user_data parameter; the second is the index in the list
@@ -218,7 +219,8 @@
  *
  * @constreturn The list of required fields.
  */
-GList *purple_request_fields_get_required(const PurpleRequestFields *fields);
+const GList *purple_request_fields_get_required(
+	const PurpleRequestFields *fields);
 
 /**
  * Returns a list of all validated fields.
@@ -227,7 +229,8 @@
  *
  * @constreturn The list of validated fields.
  */
-GList *purple_request_fields_get_validated(const PurpleRequestFields *fields);
+const GList *purple_request_fields_get_validatable(
+	const PurpleRequestFields *fields);
 
 /**
  * Returns whether or not a field with the specified ID is required.
@@ -579,18 +582,24 @@
  *
  * @return TRUE if the field has validator, or FALSE.
  */
-gboolean purple_request_field_is_validated(PurpleRequestField *field);
+gboolean purple_request_field_is_validatable(PurpleRequestField *field);
 
 /**
  * Checks, if specified field is valid.
  *
+ * If detailed message about failure reason is needed, there is an option to
+ * return (via errmsg argument) pointer to newly allocated error message.
+ * It must be freed with g_free after use.
+ *
  * Note: empty, not required fields are valid.
  *
  * @param field The field.
+ * @param errmsg If non-NULL, the memory area, where the pointer to validation
+ *        failure message will be set.
  *
  * @return TRUE, if the field is valid, FALSE otherwise.
  */
-gboolean purple_request_field_is_valid(PurpleRequestField *field);
+gboolean purple_request_field_is_valid(PurpleRequestField *field, gchar **errmsg);
 
 /**
  * Returns the ui_data for a field.