LCOV - code coverage report
Current view: top level - glib/gobject - gbindinggroup.c (source / functions) Hit Total Coverage
Test: unnamed Lines: 205 209 98.1 %
Date: 2024-06-11 05:24:59 Functions: 22 22 100.0 %
Branches: 52 60 86.7 %

           Branch data     Line data    Source code
       1                 :            : /* GObject - GLib Type, Object, Parameter and Signal Library
       2                 :            :  *
       3                 :            :  * Copyright (C) 2015-2022 Christian Hergert <christian@hergert.me>
       4                 :            :  * Copyright (C) 2015 Garrett Regier <garrettregier@gmail.com>
       5                 :            :  *
       6                 :            :  * This library is free software; you can redistribute it and/or
       7                 :            :  * modify it under the terms of the GNU Lesser General Public
       8                 :            :  * License as published by the Free Software Foundation; either
       9                 :            :  * version 2.1 of the License, or (at your option) any later version.
      10                 :            :  *
      11                 :            :  * This library is distributed in the hope that it will be useful,
      12                 :            :  * but WITHOUT ANY WARRANTY; without even the implied warranty of
      13                 :            :  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
      14                 :            :  * Lesser General Public License for more details.
      15                 :            :  *
      16                 :            :  * You should have received a copy of the GNU Lesser General
      17                 :            :  * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
      18                 :            :  *
      19                 :            :  * SPDX-License-Identifier: LGPL-2.1-or-later
      20                 :            :  */
      21                 :            : 
      22                 :            : #include "config.h"
      23                 :            : #include "glib.h"
      24                 :            : #include "glibintl.h"
      25                 :            : 
      26                 :            : #include "gbindinggroup.h"
      27                 :            : #include "gparamspecs.h"
      28                 :            : 
      29                 :            : /**
      30                 :            :  * GBindingGroup:
      31                 :            :  *
      32                 :            :  * `GBindingGroup` can be used to bind multiple properties
      33                 :            :  * from an object collectively.
      34                 :            :  *
      35                 :            :  * Use the various methods to bind properties from a single source
      36                 :            :  * object to multiple destination objects. Properties can be bound
      37                 :            :  * bidirectionally and are connected when the source object is set
      38                 :            :  * with [method@GObject.BindingGroup.set_source].
      39                 :            :  *
      40                 :            :  * Since: 2.72
      41                 :            :  */
      42                 :            : 
      43                 :            : #if 0
      44                 :            : # define DEBUG_BINDINGS
      45                 :            : #endif
      46                 :            : 
      47                 :            : struct _GBindingGroup
      48                 :            : {
      49                 :            :   GObject    parent_instance;
      50                 :            :   GMutex     mutex;
      51                 :            :   GObject   *source;         /* (owned weak) */
      52                 :            :   GPtrArray *lazy_bindings;  /* (owned) (element-type LazyBinding) */
      53                 :            : };
      54                 :            : 
      55                 :            : typedef struct _GBindingGroupClass
      56                 :            : {
      57                 :            :   GObjectClass parent_class;
      58                 :            : } GBindingGroupClass;
      59                 :            : 
      60                 :            : typedef struct
      61                 :            : {
      62                 :            :   GBindingGroup      *group;  /* (unowned) */
      63                 :            :   const char         *source_property;  /* (interned) */
      64                 :            :   const char         *target_property;  /* (interned) */
      65                 :            :   GObject            *target;  /* (owned weak) */
      66                 :            :   GBinding           *binding;  /* (unowned) */
      67                 :            :   gpointer            user_data;
      68                 :            :   GDestroyNotify      user_data_destroy;
      69                 :            :   gpointer            transform_to;  /* (nullable) (owned) */
      70                 :            :   gpointer            transform_from;  /* (nullable) (owned) */
      71                 :            :   GBindingFlags       binding_flags;
      72                 :            :   guint               using_closures : 1;
      73                 :            : } LazyBinding;
      74                 :            : 
      75   [ +  +  +  -  :        164 : G_DEFINE_TYPE (GBindingGroup, g_binding_group, G_TYPE_OBJECT)
                   +  + ]
      76                 :            : 
      77                 :            : typedef enum
      78                 :            : {
      79                 :            :   PROP_SOURCE = 1,
      80                 :            :   N_PROPS
      81                 :            : } GBindingGroupProperty;
      82                 :            : 
      83                 :            : static void lazy_binding_free (gpointer data);
      84                 :            : 
      85                 :            : static GParamSpec *properties[N_PROPS];
      86                 :            : 
      87                 :            : static void
      88                 :         38 : g_binding_group_connect (GBindingGroup *self,
      89                 :            :                          LazyBinding   *lazy_binding)
      90                 :            : {
      91                 :            :   GBinding *binding;
      92                 :            : 
      93                 :         38 :   g_assert (G_IS_BINDING_GROUP (self));
      94                 :         38 :   g_assert (self->source != NULL);
      95                 :         38 :   g_assert (lazy_binding != NULL);
      96                 :         38 :   g_assert (lazy_binding->binding == NULL);
      97                 :         38 :   g_assert (lazy_binding->target != NULL);
      98                 :         38 :   g_assert (lazy_binding->target_property != NULL);
      99                 :         38 :   g_assert (lazy_binding->source_property != NULL);
     100                 :            : 
     101                 :            : #ifdef DEBUG_BINDINGS
     102                 :            :   {
     103                 :            :     GFlagsClass *flags_class;
     104                 :            :     g_autofree gchar *flags_str = NULL;
     105                 :            : 
     106                 :            :     flags_class = g_type_class_ref (G_TYPE_BINDING_FLAGS);
     107                 :            :     flags_str = g_flags_to_string (flags_class, lazy_binding->binding_flags);
     108                 :            : 
     109                 :            :     g_print ("Binding %s(%p):%s to %s(%p):%s (flags=%s)\n",
     110                 :            :              G_OBJECT_TYPE_NAME (self->source),
     111                 :            :              self->source,
     112                 :            :              lazy_binding->source_property,
     113                 :            :              G_OBJECT_TYPE_NAME (lazy_binding->target),
     114                 :            :              lazy_binding->target,
     115                 :            :              lazy_binding->target_property,
     116                 :            :              flags_str);
     117                 :            : 
     118                 :            :     g_type_class_unref (flags_class);
     119                 :            :   }
     120                 :            : #endif
     121                 :            : 
     122         [ +  + ]:         38 :   if (!lazy_binding->using_closures)
     123                 :         37 :     binding = g_object_bind_property_full (self->source,
     124                 :         37 :                                            lazy_binding->source_property,
     125                 :         37 :                                            lazy_binding->target,
     126                 :         37 :                                            lazy_binding->target_property,
     127                 :            :                                            lazy_binding->binding_flags,
     128                 :         37 :                                            lazy_binding->transform_to,
     129                 :         37 :                                            lazy_binding->transform_from,
     130                 :            :                                            lazy_binding->user_data,
     131                 :            :                                            NULL);
     132                 :            :   else
     133                 :          1 :     binding = g_object_bind_property_with_closures (self->source,
     134                 :          1 :                                                     lazy_binding->source_property,
     135                 :          1 :                                                     lazy_binding->target,
     136                 :          1 :                                                     lazy_binding->target_property,
     137                 :            :                                                     lazy_binding->binding_flags,
     138                 :          1 :                                                     lazy_binding->transform_to,
     139                 :          1 :                                                     lazy_binding->transform_from);
     140                 :            : 
     141                 :         38 :   lazy_binding->binding = binding;
     142                 :         38 : }
     143                 :            : 
     144                 :            : static void
     145                 :         43 : g_binding_group_disconnect (LazyBinding *lazy_binding)
     146                 :            : {
     147                 :         43 :   g_assert (lazy_binding != NULL);
     148                 :            : 
     149         [ +  + ]:         43 :   if (lazy_binding->binding != NULL)
     150                 :            :     {
     151                 :         35 :       g_binding_unbind (lazy_binding->binding);
     152                 :         35 :       lazy_binding->binding = NULL;
     153                 :            :     }
     154                 :         43 : }
     155                 :            : 
     156                 :            : static void
     157                 :          4 : g_binding_group__source_weak_notify (gpointer  data,
     158                 :            :                                      GObject  *where_object_was)
     159                 :            : {
     160                 :          4 :   GBindingGroup *self = data;
     161                 :            :   guint i;
     162                 :            : 
     163                 :          4 :   g_assert (G_IS_BINDING_GROUP (self));
     164                 :            : 
     165                 :          4 :   g_mutex_lock (&self->mutex);
     166                 :            : 
     167                 :          4 :   self->source = NULL;
     168                 :            : 
     169         [ +  + ]:          5 :   for (i = 0; i < self->lazy_bindings->len; i++)
     170                 :            :     {
     171                 :          1 :       LazyBinding *lazy_binding = g_ptr_array_index (self->lazy_bindings, i);
     172                 :            : 
     173                 :          1 :       lazy_binding->binding = NULL;
     174                 :            :     }
     175                 :            : 
     176                 :          4 :   g_mutex_unlock (&self->mutex);
     177                 :          4 : }
     178                 :            : 
     179                 :            : static void
     180                 :          5 : g_binding_group__target_weak_notify (gpointer  data,
     181                 :            :                                      GObject  *where_object_was)
     182                 :            : {
     183                 :          5 :   GBindingGroup *self = data;
     184                 :          5 :   LazyBinding *to_free = NULL;
     185                 :            :   guint i;
     186                 :            : 
     187                 :          5 :   g_assert (G_IS_BINDING_GROUP (self));
     188                 :            : 
     189                 :          5 :   g_mutex_lock (&self->mutex);
     190                 :            : 
     191         [ +  - ]:          5 :   for (i = 0; i < self->lazy_bindings->len; i++)
     192                 :            :     {
     193                 :          5 :       LazyBinding *lazy_binding = g_ptr_array_index (self->lazy_bindings, i);
     194                 :            : 
     195         [ +  - ]:          5 :       if (lazy_binding->target == where_object_was)
     196                 :            :         {
     197                 :          5 :           lazy_binding->target = NULL;
     198                 :          5 :           lazy_binding->binding = NULL;
     199                 :            : 
     200                 :          5 :           to_free = g_ptr_array_steal_index_fast (self->lazy_bindings, i);
     201                 :          5 :           break;
     202                 :            :         }
     203                 :            :     }
     204                 :            : 
     205                 :          5 :   g_mutex_unlock (&self->mutex);
     206                 :            : 
     207         [ +  - ]:          5 :   if (to_free != NULL)
     208                 :          5 :     lazy_binding_free (to_free);
     209                 :          5 : }
     210                 :            : 
     211                 :            : static void
     212                 :         18 : lazy_binding_free (gpointer data)
     213                 :            : {
     214                 :         18 :   LazyBinding *lazy_binding = data;
     215                 :            : 
     216         [ +  + ]:         18 :   if (lazy_binding->target != NULL)
     217                 :            :     {
     218                 :         13 :       g_object_weak_unref (lazy_binding->target,
     219                 :            :                            g_binding_group__target_weak_notify,
     220                 :         13 :                            lazy_binding->group);
     221                 :         13 :       lazy_binding->target = NULL;
     222                 :            :     }
     223                 :            : 
     224                 :         18 :   g_binding_group_disconnect (lazy_binding);
     225                 :            : 
     226                 :         18 :   lazy_binding->group = NULL;
     227                 :         18 :   lazy_binding->source_property = NULL;
     228                 :         18 :   lazy_binding->target_property = NULL;
     229                 :            : 
     230         [ +  + ]:         18 :   if (lazy_binding->user_data_destroy)
     231                 :          1 :     lazy_binding->user_data_destroy (lazy_binding->user_data);
     232                 :            : 
     233         [ +  + ]:         18 :   if (lazy_binding->using_closures)
     234                 :            :     {
     235                 :          1 :       g_clear_pointer (&lazy_binding->transform_to, g_closure_unref);
     236                 :          1 :       g_clear_pointer (&lazy_binding->transform_from, g_closure_unref);
     237                 :            :     }
     238                 :            : 
     239                 :         18 :   g_slice_free (LazyBinding, lazy_binding);
     240                 :         18 : }
     241                 :            : 
     242                 :            : static void
     243                 :         12 : g_binding_group_dispose (GObject *object)
     244                 :            : {
     245                 :         12 :   GBindingGroup *self = (GBindingGroup *)object;
     246                 :         12 :   LazyBinding **lazy_bindings = NULL;
     247                 :         12 :   gsize len = 0;
     248                 :            :   gsize i;
     249                 :            : 
     250                 :         12 :   g_assert (G_IS_BINDING_GROUP (self));
     251                 :            : 
     252                 :         12 :   g_mutex_lock (&self->mutex);
     253                 :            : 
     254         [ +  + ]:         12 :   if (self->source != NULL)
     255                 :            :     {
     256                 :          2 :       g_object_weak_unref (self->source,
     257                 :            :                            g_binding_group__source_weak_notify,
     258                 :            :                            self);
     259                 :          2 :       self->source = NULL;
     260                 :            :     }
     261                 :            : 
     262         [ +  + ]:         12 :   if (self->lazy_bindings->len > 0)
     263                 :          5 :     lazy_bindings = (LazyBinding **)g_ptr_array_steal (self->lazy_bindings, &len);
     264                 :            : 
     265                 :         12 :   g_mutex_unlock (&self->mutex);
     266                 :            : 
     267                 :            :   /* Free bindings without holding self->mutex to avoid re-entrancy
     268                 :            :    * from collateral damage through release of binding closure data,
     269                 :            :    * GDataList, etc.
     270                 :            :    */
     271         [ +  + ]:         25 :   for (i = 0; i < len; i++)
     272                 :         13 :     lazy_binding_free (lazy_bindings[i]);
     273                 :         12 :   g_free (lazy_bindings);
     274                 :            : 
     275                 :         12 :   G_OBJECT_CLASS (g_binding_group_parent_class)->dispose (object);
     276                 :         12 : }
     277                 :            : 
     278                 :            : static void
     279                 :         12 : g_binding_group_finalize (GObject *object)
     280                 :            : {
     281                 :         12 :   GBindingGroup *self = (GBindingGroup *)object;
     282                 :            : 
     283                 :         12 :   g_assert (self->lazy_bindings != NULL);
     284                 :         12 :   g_assert (self->lazy_bindings->len == 0);
     285                 :            : 
     286                 :         12 :   g_clear_pointer (&self->lazy_bindings, g_ptr_array_unref);
     287                 :         12 :   g_mutex_clear (&self->mutex);
     288                 :            : 
     289                 :         12 :   G_OBJECT_CLASS (g_binding_group_parent_class)->finalize (object);
     290                 :         12 : }
     291                 :            : 
     292                 :            : static void
     293                 :          3 : g_binding_group_get_property (GObject    *object,
     294                 :            :                               guint       prop_id,
     295                 :            :                               GValue     *value,
     296                 :            :                               GParamSpec *pspec)
     297                 :            : {
     298                 :          3 :   GBindingGroup *self = G_BINDING_GROUP (object);
     299                 :            : 
     300         [ +  - ]:          3 :   switch ((GBindingGroupProperty) prop_id)
     301                 :            :     {
     302                 :          3 :     case PROP_SOURCE:
     303                 :          3 :       g_value_take_object (value, g_binding_group_dup_source (self));
     304                 :          3 :       break;
     305                 :            : 
     306                 :          0 :     default:
     307                 :          0 :       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
     308                 :            :     }
     309                 :          3 : }
     310                 :            : 
     311                 :            : static void
     312                 :          1 : g_binding_group_set_property (GObject      *object,
     313                 :            :                               guint         prop_id,
     314                 :            :                               const GValue *value,
     315                 :            :                               GParamSpec   *pspec)
     316                 :            : {
     317                 :          1 :   GBindingGroup *self = G_BINDING_GROUP (object);
     318                 :            : 
     319         [ +  - ]:          1 :   switch ((GBindingGroupProperty) prop_id)
     320                 :            :     {
     321                 :          1 :     case PROP_SOURCE:
     322                 :          1 :       g_binding_group_set_source (self, g_value_get_object (value));
     323                 :          1 :       break;
     324                 :            : 
     325                 :          0 :     default:
     326                 :          0 :       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
     327                 :            :     }
     328                 :          1 : }
     329                 :            : 
     330                 :            : static void
     331                 :          3 : g_binding_group_class_init (GBindingGroupClass *klass)
     332                 :            : {
     333                 :          3 :   GObjectClass *object_class = G_OBJECT_CLASS (klass);
     334                 :            : 
     335                 :          3 :   object_class->dispose = g_binding_group_dispose;
     336                 :          3 :   object_class->finalize = g_binding_group_finalize;
     337                 :          3 :   object_class->get_property = g_binding_group_get_property;
     338                 :          3 :   object_class->set_property = g_binding_group_set_property;
     339                 :            : 
     340                 :            :   /**
     341                 :            :    * GBindingGroup:source:
     342                 :            :    *
     343                 :            :    * The source object used for binding properties.
     344                 :            :    *
     345                 :            :    * Since: 2.72
     346                 :            :    */
     347                 :          3 :   properties[PROP_SOURCE] =
     348                 :          3 :       g_param_spec_object ("source", NULL, NULL,
     349                 :            :                            G_TYPE_OBJECT,
     350                 :            :                            (G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY | G_PARAM_STATIC_STRINGS));
     351                 :            : 
     352                 :          3 :   g_object_class_install_properties (object_class, N_PROPS, properties);
     353                 :          3 : }
     354                 :            : 
     355                 :            : static void
     356                 :         12 : g_binding_group_init (GBindingGroup *self)
     357                 :            : {
     358                 :         12 :   g_mutex_init (&self->mutex);
     359                 :         12 :   self->lazy_bindings = g_ptr_array_new_with_free_func (lazy_binding_free);
     360                 :         12 : }
     361                 :            : 
     362                 :            : /**
     363                 :            :  * g_binding_group_new:
     364                 :            :  *
     365                 :            :  * Creates a new #GBindingGroup.
     366                 :            :  *
     367                 :            :  * Returns: (transfer full): a new #GBindingGroup
     368                 :            :  *
     369                 :            :  * Since: 2.72
     370                 :            :  */
     371                 :            : GBindingGroup *
     372                 :         11 : g_binding_group_new (void)
     373                 :            : {
     374                 :         11 :   return g_object_new (G_TYPE_BINDING_GROUP, NULL);
     375                 :            : }
     376                 :            : 
     377                 :            : /**
     378                 :            :  * g_binding_group_dup_source:
     379                 :            :  * @self: the #GBindingGroup
     380                 :            :  *
     381                 :            :  * Gets the source object used for binding properties.
     382                 :            :  *
     383                 :            :  * Returns: (transfer none) (nullable) (type GObject): a #GObject or %NULL.
     384                 :            :  *
     385                 :            :  * Since: 2.72
     386                 :            :  */
     387                 :            : gpointer
     388                 :         17 : g_binding_group_dup_source (GBindingGroup *self)
     389                 :            : {
     390                 :            :   GObject *source;
     391                 :            : 
     392                 :         17 :   g_return_val_if_fail (G_IS_BINDING_GROUP (self), NULL);
     393                 :            : 
     394                 :         17 :   g_mutex_lock (&self->mutex);
     395         [ +  + ]:         17 :   source = self->source ? g_object_ref (self->source) : NULL;
     396                 :         17 :   g_mutex_unlock (&self->mutex);
     397                 :            : 
     398                 :         17 :   return source;
     399                 :            : }
     400                 :            : 
     401                 :            : static gboolean
     402                 :         17 : g_binding_group_check_source (GBindingGroup *self,
     403                 :            :                               gpointer       source)
     404                 :            : {
     405                 :            :   guint i;
     406                 :            : 
     407                 :         17 :   g_assert (G_IS_BINDING_GROUP (self));
     408                 :         17 :   g_assert (!source || G_IS_OBJECT (source));
     409                 :            : 
     410         [ +  + ]:         49 :   for (i = 0; i < self->lazy_bindings->len; i++)
     411                 :            :     {
     412                 :         33 :       LazyBinding *lazy_binding = g_ptr_array_index (self->lazy_bindings, i);
     413                 :            : 
     414                 :         33 :       g_return_val_if_fail (g_object_class_find_property (G_OBJECT_GET_CLASS (source),
     415                 :            :                                                           lazy_binding->source_property) != NULL,
     416                 :            :                             FALSE);
     417                 :            :     }
     418                 :            : 
     419                 :         16 :   return TRUE;
     420                 :            : }
     421                 :            : 
     422                 :            : /**
     423                 :            :  * g_binding_group_set_source:
     424                 :            :  * @self: the #GBindingGroup
     425                 :            :  * @source: (type GObject) (nullable) (transfer none): the source #GObject,
     426                 :            :  *   or %NULL to clear it
     427                 :            :  *
     428                 :            :  * Sets @source as the source object used for creating property
     429                 :            :  * bindings. If there is already a source object all bindings from it
     430                 :            :  * will be removed.
     431                 :            :  *
     432                 :            :  * Note that all properties that have been bound must exist on @source.
     433                 :            :  *
     434                 :            :  * Since: 2.72
     435                 :            :  */
     436                 :            : void
     437                 :         28 : g_binding_group_set_source (GBindingGroup *self,
     438                 :            :                             gpointer       source)
     439                 :            : {
     440                 :         28 :   gboolean notify = FALSE;
     441                 :            : 
     442                 :         28 :   g_return_if_fail (G_IS_BINDING_GROUP (self));
     443                 :         28 :   g_return_if_fail (!source || G_IS_OBJECT (source));
     444                 :         28 :   g_return_if_fail (source != (gpointer) self);
     445                 :            : 
     446                 :         28 :   g_mutex_lock (&self->mutex);
     447                 :            : 
     448         [ +  + ]:         28 :   if (source == (gpointer) self->source)
     449                 :          1 :     goto unlock;
     450                 :            : 
     451         [ +  + ]:         27 :   if (self->source != NULL)
     452                 :            :     {
     453                 :            :       guint i;
     454                 :            : 
     455                 :         10 :       g_object_weak_unref (self->source,
     456                 :            :                            g_binding_group__source_weak_notify,
     457                 :            :                            self);
     458                 :         10 :       self->source = NULL;
     459                 :            : 
     460         [ +  + ]:         35 :       for (i = 0; i < self->lazy_bindings->len; i++)
     461                 :            :         {
     462                 :         25 :           LazyBinding *lazy_binding = g_ptr_array_index (self->lazy_bindings, i);
     463                 :            : 
     464                 :         25 :           g_binding_group_disconnect (lazy_binding);
     465                 :            :         }
     466                 :            :     }
     467                 :            : 
     468   [ +  +  +  + ]:         27 :   if (source != NULL && g_binding_group_check_source (self, source))
     469                 :            :     {
     470                 :            :       guint i;
     471                 :            : 
     472                 :         16 :       self->source = source;
     473                 :         16 :       g_object_weak_ref (self->source,
     474                 :            :                          g_binding_group__source_weak_notify,
     475                 :            :                          self);
     476                 :            : 
     477         [ +  + ]:         48 :       for (i = 0; i < self->lazy_bindings->len; i++)
     478                 :            :         {
     479                 :            :           LazyBinding *lazy_binding;
     480                 :            : 
     481                 :         32 :           lazy_binding = g_ptr_array_index (self->lazy_bindings, i);
     482                 :         32 :           g_binding_group_connect (self, lazy_binding);
     483                 :            :         }
     484                 :            :     }
     485                 :            : 
     486                 :         27 :   notify = TRUE;
     487                 :            : 
     488                 :         28 : unlock:
     489                 :         28 :   g_mutex_unlock (&self->mutex);
     490                 :            : 
     491         [ +  + ]:         28 :   if (notify)
     492                 :         27 :     g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_SOURCE]);
     493                 :            : }
     494                 :            : 
     495                 :            : static void
     496                 :         20 : g_binding_group_bind_helper (GBindingGroup  *self,
     497                 :            :                              const gchar    *source_property,
     498                 :            :                              gpointer        target,
     499                 :            :                              const gchar    *target_property,
     500                 :            :                              GBindingFlags   flags,
     501                 :            :                              gpointer        transform_to,
     502                 :            :                              gpointer        transform_from,
     503                 :            :                              gpointer        user_data,
     504                 :            :                              GDestroyNotify  user_data_destroy,
     505                 :            :                              gboolean        using_closures)
     506                 :            : {
     507                 :            :   LazyBinding *lazy_binding;
     508                 :            : 
     509                 :         20 :   g_return_if_fail (G_IS_BINDING_GROUP (self));
     510                 :         20 :   g_return_if_fail (source_property != NULL);
     511                 :         20 :   g_return_if_fail (self->source == NULL ||
     512                 :            :                     g_object_class_find_property (G_OBJECT_GET_CLASS (self->source),
     513                 :            :                                                   source_property) != NULL);
     514                 :         19 :   g_return_if_fail (G_IS_OBJECT (target));
     515                 :         19 :   g_return_if_fail (target_property != NULL);
     516                 :         19 :   g_return_if_fail (g_object_class_find_property (G_OBJECT_GET_CLASS (target),
     517                 :            :                                                   target_property) != NULL);
     518                 :         18 :   g_return_if_fail (target != (gpointer) self ||
     519                 :            :                     strcmp (source_property, target_property) != 0);
     520                 :            : 
     521                 :         18 :   g_mutex_lock (&self->mutex);
     522                 :            : 
     523                 :         18 :   lazy_binding = g_slice_new0 (LazyBinding);
     524                 :         18 :   lazy_binding->group = self;
     525                 :         18 :   lazy_binding->source_property = g_intern_string (source_property);
     526                 :         18 :   lazy_binding->target_property = g_intern_string (target_property);
     527                 :         18 :   lazy_binding->target = target;
     528                 :         18 :   lazy_binding->binding_flags = flags | G_BINDING_SYNC_CREATE;
     529                 :         18 :   lazy_binding->user_data = user_data;
     530                 :         18 :   lazy_binding->user_data_destroy = user_data_destroy;
     531                 :         18 :   lazy_binding->transform_to = transform_to;
     532                 :         18 :   lazy_binding->transform_from = transform_from;
     533                 :            : 
     534         [ +  + ]:         18 :   if (using_closures)
     535                 :            :     {
     536                 :          1 :       lazy_binding->using_closures = TRUE;
     537                 :            : 
     538         [ +  - ]:          1 :       if (transform_to != NULL)
     539                 :          1 :         g_closure_sink (g_closure_ref (transform_to));
     540                 :            : 
     541         [ +  - ]:          1 :       if (transform_from != NULL)
     542                 :          1 :         g_closure_sink (g_closure_ref (transform_from));
     543                 :            :     }
     544                 :            : 
     545                 :         18 :   g_object_weak_ref (target,
     546                 :            :                      g_binding_group__target_weak_notify,
     547                 :            :                      self);
     548                 :            : 
     549                 :         18 :   g_ptr_array_add (self->lazy_bindings, lazy_binding);
     550                 :            : 
     551         [ +  + ]:         18 :   if (self->source != NULL)
     552                 :          6 :     g_binding_group_connect (self, lazy_binding);
     553                 :            : 
     554                 :         18 :   g_mutex_unlock (&self->mutex);
     555                 :            : }
     556                 :            : 
     557                 :            : /**
     558                 :            :  * g_binding_group_bind:
     559                 :            :  * @self: the #GBindingGroup
     560                 :            :  * @source_property: the property on the source to bind
     561                 :            :  * @target: (type GObject) (transfer none) (not nullable): the target #GObject
     562                 :            :  * @target_property: the property on @target to bind
     563                 :            :  * @flags: the flags used to create the #GBinding
     564                 :            :  *
     565                 :            :  * Creates a binding between @source_property on the source object
     566                 :            :  * and @target_property on @target. Whenever the @source_property
     567                 :            :  * is changed the @target_property is updated using the same value.
     568                 :            :  * The binding flag %G_BINDING_SYNC_CREATE is automatically specified.
     569                 :            :  *
     570                 :            :  * See g_object_bind_property() for more information.
     571                 :            :  *
     572                 :            :  * Since: 2.72
     573                 :            :  */
     574                 :            : void
     575                 :         17 : g_binding_group_bind (GBindingGroup *self,
     576                 :            :                       const gchar   *source_property,
     577                 :            :                       gpointer       target,
     578                 :            :                       const gchar   *target_property,
     579                 :            :                       GBindingFlags  flags)
     580                 :            : {
     581                 :         17 :   g_binding_group_bind_full (self, source_property,
     582                 :            :                              target, target_property,
     583                 :            :                              flags,
     584                 :            :                              NULL, NULL,
     585                 :            :                              NULL, NULL);
     586                 :         17 : }
     587                 :            : 
     588                 :            : /**
     589                 :            :  * g_binding_group_bind_full:
     590                 :            :  * @self: the #GBindingGroup
     591                 :            :  * @source_property: the property on the source to bind
     592                 :            :  * @target: (type GObject) (transfer none) (not nullable): the target #GObject
     593                 :            :  * @target_property: the property on @target to bind
     594                 :            :  * @flags: the flags used to create the #GBinding
     595                 :            :  * @transform_to: (scope notified) (nullable): the transformation function
     596                 :            :  *     from the source object to the @target, or %NULL to use the default
     597                 :            :  * @transform_from: (scope notified) (nullable): the transformation function
     598                 :            :  *     from the @target to the source object, or %NULL to use the default
     599                 :            :  * @user_data: custom data to be passed to the transformation
     600                 :            :  *             functions, or %NULL
     601                 :            :  * @user_data_destroy: function to be called when disposing the binding,
     602                 :            :  *     to free the resources used by the transformation functions
     603                 :            :  *
     604                 :            :  * Creates a binding between @source_property on the source object and
     605                 :            :  * @target_property on @target, allowing you to set the transformation
     606                 :            :  * functions to be used by the binding. The binding flag
     607                 :            :  * %G_BINDING_SYNC_CREATE is automatically specified.
     608                 :            :  *
     609                 :            :  * See g_object_bind_property_full() for more information.
     610                 :            :  *
     611                 :            :  * Since: 2.72
     612                 :            :  */
     613                 :            : void
     614                 :         19 : g_binding_group_bind_full (GBindingGroup         *self,
     615                 :            :                            const gchar           *source_property,
     616                 :            :                            gpointer               target,
     617                 :            :                            const gchar           *target_property,
     618                 :            :                            GBindingFlags          flags,
     619                 :            :                            GBindingTransformFunc  transform_to,
     620                 :            :                            GBindingTransformFunc  transform_from,
     621                 :            :                            gpointer               user_data,
     622                 :            :                            GDestroyNotify         user_data_destroy)
     623                 :            : {
     624                 :         19 :   g_binding_group_bind_helper (self, source_property,
     625                 :            :                                target, target_property,
     626                 :            :                                flags,
     627                 :            :                                transform_to, transform_from,
     628                 :            :                                user_data, user_data_destroy,
     629                 :            :                                FALSE);
     630                 :         19 : }
     631                 :            : 
     632                 :            : /**
     633                 :            :  * g_binding_group_bind_with_closures: (rename-to g_binding_group_bind_full)
     634                 :            :  * @self: the #GBindingGroup
     635                 :            :  * @source_property: the property on the source to bind
     636                 :            :  * @target: (type GObject) (transfer none) (not nullable): the target #GObject
     637                 :            :  * @target_property: the property on @target to bind
     638                 :            :  * @flags: the flags used to create the #GBinding
     639                 :            :  * @transform_to: (nullable) (transfer none): a #GClosure wrapping the
     640                 :            :  *     transformation function from the source object to the @target,
     641                 :            :  *     or %NULL to use the default
     642                 :            :  * @transform_from: (nullable) (transfer none): a #GClosure wrapping the
     643                 :            :  *     transformation function from the @target to the source object,
     644                 :            :  *     or %NULL to use the default
     645                 :            :  *
     646                 :            :  * Creates a binding between @source_property on the source object and
     647                 :            :  * @target_property on @target, allowing you to set the transformation
     648                 :            :  * functions to be used by the binding. The binding flag
     649                 :            :  * %G_BINDING_SYNC_CREATE is automatically specified.
     650                 :            :  *
     651                 :            :  * This function is the language bindings friendly version of
     652                 :            :  * g_binding_group_bind_property_full(), using #GClosures
     653                 :            :  * instead of function pointers.
     654                 :            :  *
     655                 :            :  * See g_object_bind_property_with_closures() for more information.
     656                 :            :  *
     657                 :            :  * Since: 2.72
     658                 :            :  */
     659                 :            : void
     660                 :          1 : g_binding_group_bind_with_closures (GBindingGroup *self,
     661                 :            :                                     const gchar   *source_property,
     662                 :            :                                     gpointer       target,
     663                 :            :                                     const gchar   *target_property,
     664                 :            :                                     GBindingFlags  flags,
     665                 :            :                                     GClosure      *transform_to,
     666                 :            :                                     GClosure      *transform_from)
     667                 :            : {
     668                 :          1 :   g_binding_group_bind_helper (self, source_property,
     669                 :            :                                target, target_property,
     670                 :            :                                flags,
     671                 :            :                                transform_to, transform_from,
     672                 :            :                                NULL, NULL,
     673                 :            :                                TRUE);
     674                 :          1 : }

Generated by: LCOV version 1.14