| /* -*- Mode: C; indent-tabs-mode: nil; c-basic-offset: 8 -*- */ |
| |
| /* libcroco - Library for parsing and applying CSS |
| * Copyright (C) 2006-2019 Free Software Foundation, Inc. |
| * |
| * This file is not part of the GNU gettext program, but is used with |
| * GNU gettext. |
| * |
| * The original copyright notice is as follows: |
| */ |
| |
| /* |
| * This file is part of The Croco Library |
| * |
| * Copyright (C) 2003-2004 Dodji Seketeli. All Rights Reserved. |
| * |
| * This program is free software; you can redistribute it and/or |
| * modify it under the terms of version 2.1 of the GNU Lesser General Public |
| * License as published by the Free Software Foundation. |
| * |
| * This program 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 Lesser General Public License |
| * along with this program; if not, write to the Free Software |
| * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 |
| * USA |
| */ |
| |
| #include <config.h> |
| #include <string.h> |
| #include "cr-doc-handler.h" |
| #include "cr-parser.h" |
| |
| /** |
| *@CRDocHandler: |
| * |
| *The definition of the CRDocHandler class. |
| *Contains methods to instantiate, destroy, |
| *and initialyze instances of #CRDocHandler |
| *to custom values. |
| */ |
| |
| #define PRIVATE(obj) (obj)->priv |
| |
| struct _CRDocHandlerPriv { |
| /** |
| *This pointer is to hold an application parsing context. |
| *For example, it used by the Object Model parser to |
| *store it parsing context. #CRParser does not touch it, but |
| *#CROMParser does. #CROMParser allocates this pointer at |
| *the beginning of the css document, and frees it at the end |
| *of the document. |
| */ |
| gpointer context; |
| |
| /** |
| *The place where #CROMParser puts the result of its parsing, if |
| *any. |
| */ |
| gpointer result; |
| /** |
| *a pointer to the parser used to parse |
| *the current document. |
| */ |
| CRParser *parser ; |
| }; |
| |
| /** |
| * cr_doc_handler_new: |
| *Constructor of #CRDocHandler. |
| * |
| *Returns the newly built instance of |
| *#CRDocHandler |
| * |
| */ |
| CRDocHandler * |
| cr_doc_handler_new (void) |
| { |
| CRDocHandler *result = NULL; |
| |
| result = g_try_malloc (sizeof (CRDocHandler)); |
| |
| g_return_val_if_fail (result, NULL); |
| |
| memset (result, 0, sizeof (CRDocHandler)); |
| result->ref_count++; |
| |
| result->priv = g_try_malloc (sizeof (CRDocHandlerPriv)); |
| if (!result->priv) { |
| cr_utils_trace_info ("Out of memory exception"); |
| g_free (result); |
| return NULL; |
| } |
| |
| cr_doc_handler_set_default_sac_handler (result); |
| |
| return result; |
| } |
| |
| /** |
| * cr_doc_handler_get_ctxt: |
| *@a_this: the current instance of #CRDocHandler. |
| *@a_ctxt: out parameter. The new parsing context. |
| * |
| *Gets the private parsing context associated to the document handler |
| *The private parsing context is used by libcroco only. |
| * |
| *Returns CR_OK upon successfull completion, an error code otherwise. |
| */ |
| enum CRStatus |
| cr_doc_handler_get_ctxt (CRDocHandler const * a_this, gpointer * a_ctxt) |
| { |
| g_return_val_if_fail (a_this && a_this->priv, CR_BAD_PARAM_ERROR); |
| |
| *a_ctxt = a_this->priv->context; |
| |
| return CR_OK; |
| } |
| |
| /** |
| * cr_doc_handler_set_ctxt: |
| *@a_this: the current instance of #CRDocHandler |
| *@a_ctxt: a pointer to the parsing context. |
| * |
| *Sets the private parsing context. |
| *This is used by libcroco only. |
| *Returns CR_OK upon successfull completion, an error code otherwise. |
| */ |
| enum CRStatus |
| cr_doc_handler_set_ctxt (CRDocHandler * a_this, gpointer a_ctxt) |
| { |
| g_return_val_if_fail (a_this && a_this->priv, CR_BAD_PARAM_ERROR); |
| a_this->priv->context = a_ctxt; |
| return CR_OK; |
| } |
| |
| /** |
| * cr_doc_handler_get_result: |
| *@a_this: the current instance of #CRDocHandler |
| *@a_result: out parameter. The returned result. |
| * |
| *Gets the private parsing result. |
| *The private parsing result is used by libcroco only. |
| * |
| *Returns CR_OK upon successfull completion, an error code otherwise. |
| */ |
| enum CRStatus |
| cr_doc_handler_get_result (CRDocHandler const * a_this, gpointer * a_result) |
| { |
| g_return_val_if_fail (a_this && a_this->priv, CR_BAD_PARAM_ERROR); |
| |
| *a_result = a_this->priv->result; |
| |
| return CR_OK; |
| } |
| |
| /** |
| * cr_doc_handler_set_result: |
| *@a_this: the current instance of #CRDocHandler |
| *@a_result: the new result. |
| * |
| *Sets the private parsing context. |
| *This is used by libcroco only. |
| * |
| *Returns CR_OK upon successfull completion, an error code otherwise. |
| */ |
| enum CRStatus |
| cr_doc_handler_set_result (CRDocHandler * a_this, gpointer a_result) |
| { |
| g_return_val_if_fail (a_this && a_this->priv, CR_BAD_PARAM_ERROR); |
| a_this->priv->result = a_result; |
| return CR_OK; |
| } |
| |
| /** |
| *cr_doc_handler_set_default_sac_handler: |
| *@a_this: a pointer to the current instance of #CRDocHandler. |
| * |
| *Sets the sac handlers contained in the current |
| *instance of DocHandler to the default handlers. |
| *For the time being the default handlers are |
| *test handlers. This is expected to change in a |
| *near future, when the libcroco gets a bit debugged. |
| * |
| *Returns CR_OK upon successfull completion, an error code otherwise. |
| */ |
| enum CRStatus |
| cr_doc_handler_set_default_sac_handler (CRDocHandler * a_this) |
| { |
| g_return_val_if_fail (a_this, CR_BAD_PARAM_ERROR); |
| |
| a_this->start_document = NULL; |
| a_this->end_document = NULL; |
| a_this->import_style = NULL; |
| a_this->namespace_declaration = NULL; |
| a_this->comment = NULL; |
| a_this->start_selector = NULL; |
| a_this->end_selector = NULL; |
| a_this->property = NULL; |
| a_this->start_font_face = NULL; |
| a_this->end_font_face = NULL; |
| a_this->start_media = NULL; |
| a_this->end_media = NULL; |
| a_this->start_page = NULL; |
| a_this->end_page = NULL; |
| a_this->ignorable_at_rule = NULL; |
| a_this->error = NULL; |
| a_this->unrecoverable_error = NULL; |
| return CR_OK; |
| } |
| |
| /** |
| * cr_doc_handler_ref: |
| *@a_this: the current instance of #CRDocHandler. |
| */ |
| void |
| cr_doc_handler_ref (CRDocHandler * a_this) |
| { |
| g_return_if_fail (a_this); |
| |
| a_this->ref_count++; |
| } |
| |
| /** |
| * cr_doc_handler_unref: |
| *@a_this: the currrent instance of #CRDocHandler. |
| * |
| *Decreases the ref count of the current instance of #CRDocHandler. |
| *If the ref count reaches '0' then, destroys the instance. |
| * |
| *Returns TRUE if the instance as been destroyed, FALSE otherwise. |
| */ |
| gboolean |
| cr_doc_handler_unref (CRDocHandler * a_this) |
| { |
| g_return_val_if_fail (a_this, FALSE); |
| |
| if (a_this->ref_count > 0) { |
| a_this->ref_count--; |
| } |
| |
| if (a_this->ref_count == 0) { |
| cr_doc_handler_destroy (a_this); |
| return TRUE; |
| } |
| return FALSE ; |
| } |
| |
| /** |
| * cr_doc_handler_destroy: |
| *@a_this: the instance of #CRDocHandler to |
| *destroy. |
| * |
| *The destructor of the #CRDocHandler class. |
| */ |
| void |
| cr_doc_handler_destroy (CRDocHandler * a_this) |
| { |
| g_return_if_fail (a_this); |
| |
| if (a_this->priv) { |
| g_free (a_this->priv); |
| a_this->priv = NULL; |
| } |
| g_free (a_this); |
| } |
| |
| /** |
| * cr_doc_handler_associate_a_parser: |
| *Associates a parser to the current document handler |
| * |
| *@a_this: the current instance of document handler. |
| *@a_parser: the parser to associate. |
| */ |
| void |
| cr_doc_handler_associate_a_parser (CRDocHandler *a_this, |
| gpointer a_parser) |
| { |
| g_return_if_fail (a_this && PRIVATE (a_this) |
| && a_parser) ; |
| |
| PRIVATE (a_this)->parser = a_parser ; |
| } |