Virtual Method

PurpleRequestFieldis_valid

unstable since: 3.0

Declaration [src]

gboolean
is_valid (
  PurpleRequestField* field,
  char** errmsg
)

Description [src]

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: Required, but unfilled, fields are invalid.

Available since: 3.0

Parameters

errmsg

Type: char**

If non-NULL, the memory area, where the validation failure message will be returned.

The argument will be set by the function.

The argument can be set to NULL by the virtual function.

The argument can be NULL.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.

The value is a NUL terminated UTF-8 string.

Return value

Type: gboolean

TRUE, if the field is valid, FALSE otherwise.