mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-08-01 15:03:39 +02:00
gobject: Add g_{param_spec,signal}_is_valid_name() functions
Making this validation code public allows projects to validate a GParamSpec name before creating it. While hard-coded GParamSpec don't need this, we can't afford crashing the main program for dynamically generated GParamSpec from user-created data. In such case, we will need to validate the param names and return errors instead of trying to create a GParamSpec with invalid names. Includes modifications from Philip Withnall and Emmanuele Bassi to rearrange the new function addition and split it into one function for GParamSpecs and one for GSignals.
This commit is contained in:
@@ -381,20 +381,34 @@ is_canonical (const gchar *key)
|
||||
return (strchr (key, '_') == NULL);
|
||||
}
|
||||
|
||||
static gboolean
|
||||
is_valid_property_name (const gchar *key)
|
||||
/**
|
||||
* g_param_spec_is_valid_name:
|
||||
* @name: the canonical name of the property
|
||||
*
|
||||
* Validate a property name for a #GParamSpec. This can be useful for
|
||||
* dynamically-generated properties which need to be validated at run-time
|
||||
* before actually trying to create them.
|
||||
*
|
||||
* See [canonical parameter names][canonical-parameter-names] for details of
|
||||
* the rules for valid names.
|
||||
*
|
||||
* Returns: %TRUE if @name is a valid property name, %FALSE otherwise.
|
||||
* Since: 2.66
|
||||
*/
|
||||
gboolean
|
||||
g_param_spec_is_valid_name (const gchar *name)
|
||||
{
|
||||
const gchar *p;
|
||||
|
||||
/* First character must be a letter. */
|
||||
if ((key[0] < 'A' || key[0] > 'Z') &&
|
||||
(key[0] < 'a' || key[0] > 'z'))
|
||||
if ((name[0] < 'A' || name[0] > 'Z') &&
|
||||
(name[0] < 'a' || name[0] > 'z'))
|
||||
return FALSE;
|
||||
|
||||
for (p = key; *p != 0; p++)
|
||||
for (p = name; *p != 0; p++)
|
||||
{
|
||||
const gchar c = *p;
|
||||
|
||||
|
||||
if (c != '-' && c != '_' &&
|
||||
(c < '0' || c > '9') &&
|
||||
(c < 'A' || c > 'Z') &&
|
||||
@@ -439,7 +453,7 @@ g_param_spec_internal (GType param_type,
|
||||
|
||||
g_return_val_if_fail (G_TYPE_IS_PARAM (param_type) && param_type != G_TYPE_PARAM, NULL);
|
||||
g_return_val_if_fail (name != NULL, NULL);
|
||||
g_return_val_if_fail (is_valid_property_name (name), NULL);
|
||||
g_return_val_if_fail (g_param_spec_is_valid_name (name), NULL);
|
||||
g_return_val_if_fail (!(flags & G_PARAM_STATIC_NAME) || is_canonical (name), NULL);
|
||||
|
||||
pspec = (gpointer) g_type_create_instance (param_type);
|
||||
|
Reference in New Issue
Block a user