/* Chrysalide - Outil d'analyse de fichiers binaires
* generator.c - intermédiaires de génération de lignes à partir de bribres de texte
*
* Copyright (C) 2016-2024 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 Chrysalide. If not, see .
*/
#include "generator.h"
#include
#include "generator-int.h"
/* Procède à l'initialisation de l'interface de génération. */
static void g_token_generator_default_init(GTokenGeneratorInterface *);
/* Indique le nombre de ligne prêtes à être générées. */
static size_t _g_token_generator_count_one_line(const GTokenGenerator *);
/* Détermine le type d'une interface pour la mise en place de lignes. */
G_DEFINE_INTERFACE(GTokenGenerator, g_token_generator, G_TYPE_OBJECT)
/******************************************************************************
* *
* Paramètres : iface = interface GLib à initialiser. *
* *
* Description : Procède à l'initialisation de l'interface de génération. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_token_generator_default_init(GTokenGeneratorInterface *iface)
{
iface->count = _g_token_generator_count_one_line;
}
/******************************************************************************
* *
* Paramètres : generator = générateur à consulter. *
* *
* Description : Indique le nombre de ligne prêtes à être générées. *
* *
* Retour : Nombre de lignes devant apparaître au final. *
* *
* Remarques : - *
* *
******************************************************************************/
static size_t _g_token_generator_count_one_line(const GTokenGenerator *generator)
{
size_t result; /* Décompte à retourner */
result = 1;
return result;
}
/******************************************************************************
* *
* Paramètres : generator = générateur à consulter. *
* *
* Description : Indique le nombre de ligne prêtes à être générées. *
* *
* Retour : Nombre de lignes devant apparaître au final. *
* *
* Remarques : - *
* *
******************************************************************************/
size_t g_token_generator_count_lines(const GTokenGenerator *generator)
{
size_t result; /* Décompte à retourner */
GTokenGeneratorInterface *iface; /* Interface utilisée */
iface = G_TOKEN_GENERATOR_GET_IFACE(generator);
result = iface->count(generator);
return result;
}
/******************************************************************************
* *
* Paramètres : generator = générateur à consulter. *
* index = indice de cette même ligne dans le tampon global.*
* repeat = indice d'utilisations successives du générateur. *
* *
* Description : Renseigne sur les propriétés liées à un générateur. *
* *
* Retour : Propriétés particulières associées. *
* *
* Remarques : - *
* *
******************************************************************************/
BufferLineFlags g_token_generator_get_flags(const GTokenGenerator *generator, size_t index, size_t repeat)
{
BufferLineFlags result; /* Fanions à retourner */
GTokenGeneratorInterface *iface; /* Interface utilisée */
iface = G_TOKEN_GENERATOR_GET_IFACE(generator);
#ifndef NDEBUG
assert(repeat < g_token_generator_count_lines(generator));
#endif
result = iface->get_flags(generator, index, repeat);
return result;
}
/******************************************************************************
* *
* Paramètres : generator = générateur à utiliser pour l'impression. *
* index = indice de cette même ligne dans le tampon global.*
* repeat = indice d'utilisations successives du générateur. *
* line = ligne de rendu à compléter. *
* data = éventuelle donnée complémentaire fournie. *
* *
* Description : Etablit dans une ligne de rendu le contenu représenté. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
void g_token_generator_populate_line(const GTokenGenerator *generator, size_t index, size_t repeat, GBufferLine *line, void *data)
{
GTokenGeneratorInterface *iface; /* Interface utilisée */
iface = G_TOKEN_GENERATOR_GET_IFACE(generator);
#ifndef NDEBUG
assert(repeat < g_token_generator_count_lines(generator));
#endif
iface->populate(generator, index, repeat, line, data);
}
#if 0
/******************************************************************************
* *
* Paramètres : generator = générateur à consulter. *
* x = position géographique sur la ligne concernée. *
* index = indice de cette même ligne dans le tampon global.*
* repeat = indice d'utilisations successives du générateur. *
* *
* Description : Retrouve l'emplacement correspondant à une position donnée. *
* *
* Retour : Emplacement constitué. *
* *
* Remarques : - *
* *
******************************************************************************/
GLineCursor *g_token_generator_compute_cursor(const GTokenGenerator *generator, gint x, size_t index, size_t repeat)
{
GLineCursor *result; /* Emplacement à renvoyer */
GTokenGeneratorInterface *iface; /* Interface utilisée */
iface = G_TOKEN_GENERATOR_GET_IFACE(generator);
#ifndef NDEBUG
assert(repeat < g_token_generator_count_lines(generator));
#endif
iface->compute(generator, x, index, repeat, &result);
return result;
}
/******************************************************************************
* *
* Paramètres : generator = générateur à consulter. *
* index = indice de cette même ligne dans le tampon global.*
* repeat = indice d'utilisations successives du générateur. *
* cursor = emplacement à analyser. *
* *
* Description : Détermine si le conteneur s'inscrit dans une plage donnée. *
* *
* Retour : Bilan de la détermination, utilisable en comparaisons. *
* *
* Remarques : - *
* *
******************************************************************************/
int g_token_generator_contain_cursor(const GTokenGenerator *generator, size_t index, size_t repeat, const GLineCursor *cursor)
{
int result; /* Bilan d'analyse à retourner */
GTokenGeneratorInterface *iface; /* Interface utilisée */
iface = G_TOKEN_GENERATOR_GET_IFACE(generator);
#ifndef NDEBUG
assert(repeat < g_token_generator_count_lines(generator));
#endif
result = iface->contain(generator, index, repeat, cursor);
return result;
}
#endif