/* Chrysalide - Outil d'analyse de fichiers binaires
 * instance.c - partage de données d'architecture quelconques
 *
 * Copyright (C) 2016-2017 Cyrille Bagard
 *
 *  This file is part of Chrysalide.
 *
 *  Chrysalide is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  Chrysalide is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with Foobar.  If not, see <http://www.gnu.org/licenses/>.
 */


#include "instance.h"


#include <assert.h>


#include "instance-int.h"



/* Procède à l'initialisation de l'interface de partage. */
static void g_shared_instance_default_init(GSharedInstanceInterface *);



/* Détermine le type d'une interface pour le partage d'instance. */
G_DEFINE_INTERFACE(GSharedInstance, g_shared_instance, G_TYPE_OBJECT)


/******************************************************************************
*                                                                             *
*  Paramètres  : iface = interface GLib à initialiser.                        *
*                                                                             *
*  Description : Procède à l'initialisation de l'interface de partage.        *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void g_shared_instance_default_init(GSharedInstanceInterface *iface)
{

}


/******************************************************************************
*                                                                             *
*  Paramètres  : instance = objet partagé à initialiser.                      *
*                template = informations à retrouver intégralement.           *
*                                                                             *
*  Description : Initialise un nouvel objet partagé avec des informations.    *
*                                                                             *
*  Retour      : Bilan de l'opération.                                        *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

bool g_shared_instance_init(GSharedInstance *instance, const GSharedInstance *template)
{
    bool result;                            /* Bilan à retourner           */
    GSharedInstanceIface *iface;            /* Interface utilisée          */

    iface = G_SHARED_INSTANCE_GET_IFACE(instance);

    /**
     * Le compteur de références des objets GLib doit être incrémenté ici,
     * à la différence d'une opération de copie minimaliste.
     */

    result = iface->init(instance, template);

    return result;

}


/******************************************************************************
*                                                                             *
*  Paramètres  : instance = objet partagé à consulter.                        *
*                template = informations à retrouver intégralement.           *
*                                                                             *
*  Description : Réalise une copie minimale d'un contenu partagé.             *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

void g_shared_instance_quickly_copy(const GSharedInstance *instance, GSharedInstance *template)
{
    GSharedInstanceIface *iface;            /* Interface utilisée          */

    iface = G_SHARED_INSTANCE_GET_IFACE(instance);

    /**
     * Le compteur de références des objets GLib ne doit pas être incrémenté ici.
     * Ce genre de traitement est réservé à la phase d'initialisation.
     */

    iface->qck_copy(instance, template);

}


/******************************************************************************
*                                                                             *
*  Paramètres  : instance = objet partagé à consulter.                        *
*                                                                             *
*  Description : Fournit la valeur du compteur de partage.                    *
*                                                                             *
*  Retour      : Nombre de partages courant.                                  *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

unsigned int g_shared_instance_get_references(const GSharedInstance *instance)
{
    GSharedInstanceIface *iface;            /* Interface utilisée          */

    iface = G_SHARED_INSTANCE_GET_IFACE(instance);

    return iface->get_ref(instance);

}


/******************************************************************************
*                                                                             *
*  Paramètres  : instance = objet partagé à modifier.                         *
*                                                                             *
*  Description : Incrémente le compteur de partage.                           *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

void g_shared_instance_inc_references(GSharedInstance *instance)
{
    GSharedInstanceIface *iface;            /* Interface utilisée          */

    iface = G_SHARED_INSTANCE_GET_IFACE(instance);

    iface->inc_ref(instance);

}


/******************************************************************************
*                                                                             *
*  Paramètres  : instance = objet partagé à modifier.                         *
*                                                                             *
*  Description : Décrémente le compteur de partage.                           *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

void g_shared_instance_dec_references(GSharedInstance *instance)
{
    GSharedInstanceIface *iface;            /* Interface utilisée          */

    iface = G_SHARED_INSTANCE_GET_IFACE(instance);

    iface->dec_ref(instance);

}


/******************************************************************************
*                                                                             *
*  Paramètres  : a = premier objet partagé à consulter.                       *
*                b = second objet partagé à consulter.                        *
*                                                                             *
*  Description : Compare de façon accélérée un object partagé avec un autre.  *
*                                                                             *
*  Retour      : Bilan de la comparaison.                                     *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

int g_shared_instance_quickly_compare(const GSharedInstance **a, const GSharedInstance **b)
{
    int result;                             /* Bilan à faire remonter      */
    GSharedInstanceIface *iface;            /* Interface utilisée          */

    /**
     * Comme les insertions dans les tableaux triés à l'aide de qinsert()
     * font passer la clef en premier argument et que celle ci n'est pas un
     * objet valide, on inverse les arguments, puis on inverse le résultat obtenu.
     */

    iface = G_SHARED_INSTANCE_GET_IFACE(*b);

    result = iface->qck_cmp(b, a) * -1;

    return result;

}