File : tree_readers.ads
-----------------------------------------------------------------------
-- XML/Ada - An XML suite for Ada95 --
-- --
-- Copyright (C) 2001 --
-- ACT-Europe --
-- Author: Emmanuel Briot --
-- --
-- This library 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 2 of the License, or (at your option) any later version. --
-- --
-- This library 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 this library; if not, write to the --
-- Free Software Foundation, Inc., 59 Temple Place - Suite 330, --
-- Boston, MA 02111-1307, USA. --
-- --
-- As a special exception, if other files instantiate generics from --
-- this unit, or you link this unit with other files to produce an --
-- executable, this unit does not by itself cause the resulting --
-- executable to be covered by the GNU General Public License. This --
-- exception does not however invalidate any other reasons why the --
-- executable file might be covered by the GNU Public License. --
-----------------------------------------------------------------------
with Sax.Readers; use Sax.Readers;
with Sax.Attributes;
with Sax.Exceptions;
with Unicode.CES;
with DOM.Core; use DOM.Core;
package Tree_Readers is
type Tree_Reader is new Reader with private;
type Tree_Reader_Access is access all Tree_Reader'Class;
-- Special SAX Reader that creates a DOM tree in its callbacks.
-- Note that in case of a fatal error, it is your responsability to
-- free the tree, since it is left in the state it was when the error
-- was raised (for post-death analysis, if required).
function Get_Tree (Read : Tree_Reader) return Document;
procedure Free (Read : in out Tree_Reader);
-- Free the memory associated with the reader, in particular the tree.
private
type Tree_Reader is new Reader with record
Tree : Document;
Current_Node : Node;
Internal_Encoding : Unicode.CES.Encoding_Scheme;
In_DTD : Boolean := False;
end record;
procedure Start_Document (Handler : in out Tree_Reader);
procedure Start_Element
(Handler : in out Tree_Reader;
Namespace_URI : Unicode.CES.Byte_Sequence := "";
Local_Name : Unicode.CES.Byte_Sequence := "";
Qname : Unicode.CES.Byte_Sequence := "";
Atts : Sax.Attributes.Attributes'Class);
procedure End_Element
(Handler : in out Tree_Reader;
Namespace_URI : Unicode.CES.Byte_Sequence := "";
Local_Name : Unicode.CES.Byte_Sequence := "";
Qname : Unicode.CES.Byte_Sequence := "");
procedure Characters
(Handler : in out Tree_Reader;
Ch : Unicode.CES.Byte_Sequence);
procedure Ignorable_Whitespace
(Handler : in out Tree_Reader;
Ch : Unicode.CES.Byte_Sequence);
procedure Processing_Instruction
(Handler : in out Tree_Reader;
Target : Unicode.CES.Byte_Sequence;
Data : Unicode.CES.Byte_Sequence);
procedure Start_DTD
(Handler : in out Tree_Reader;
Name : Unicode.CES.Byte_Sequence;
Public_Id : Unicode.CES.Byte_Sequence := "";
System_Id : Unicode.CES.Byte_Sequence := "");
procedure End_DTD (Handler : in out Tree_Reader);
procedure Error
(Handler : in out Tree_Reader;
Except : Sax.Exceptions.Sax_Parse_Exception'Class);
procedure Warning
(Handler : in out Tree_Reader;
Except : Sax.Exceptions.Sax_Parse_Exception'Class);
end Tree_Readers;