/usr/share/ada/adainclude/xmlada_dom/dom-core-documents.ads is in libxmlada-dom7-dev 17.1.2017-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 | ------------------------------------------------------------------------------
-- XML/Ada - An XML suite for Ada95 --
-- --
-- Copyright (C) 2001-2017, AdaCore --
-- --
-- This library is free software; you can redistribute it and/or modify it --
-- under terms of the GNU General Public License as published by the Free --
-- Software Foundation; either version 3, 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 MERCHAN- --
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE. --
-- --
-- --
-- --
-- --
-- --
-- You should have received a copy of the GNU General Public License and --
-- a copy of the GCC Runtime Library Exception along with this program; --
-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
-- <http://www.gnu.org/licenses/>. --
-- --
------------------------------------------------------------------------------
package DOM.Core.Documents is
function Doc_Type (Doc : Document) return Document_Type;
-- Return the DTD associated with Doc.
-- This might return null if there is no such DTD.
function Implementation (Doc : Document) return DOM_Implementation;
-- Return the DOM_Implementation to which Doc belongs.
function Get_Element (Doc : Document) return Element;
-- Return the top-element of DOC
function Create_Element (Doc : Document; Tag_Name : DOM_String)
return Element;
-- Create a new element, and its default attributes.
-- See also Create_Element_NS
-- Invalid_Character_Err is raised if Tag_Name contains invalid
-- characters.
function Create_Element_NS
(Doc : Document;
Namespace_URI : DOM_String;
Qualified_Name : DOM_String) return Element;
function Create_Element_NS
(Doc : Document;
Symbols : Sax.Utils.Symbol_Table;
Namespace_URI : Sax.Symbols.Symbol;
Prefix : Sax.Symbols.Symbol;
Local_Name : Sax.Symbols.Symbol) return Element;
-- Create a new element, and its default attributes.
-- Invalid_Character_Err is raised if Tag_Name contains invalid
-- characters.
-- Namespace_Err raised if Qualified_Name is incorrect.
-- The version with Symbols is more efficient.
-- Symbol_Table is the table in which the symbols were allocated, to ensure
-- they are valid while the document is in use.
function Create_Document_Fragment (Doc : Document) return Document_Fragment;
-- Create an empty document fragment
function Create_Text_Node (Doc : Document; Data : DOM_String)
return Text;
-- Create a text node given a specific string
function Create_Text_Node (Doc : Document; Data : DOM_String_Access)
return Text;
-- As above but with a pre-allocated Data which must not be freed
function Create_Comment (Doc : Document; Data : DOM_String)
return Comment;
-- Create a comment node given a specific string
function Create_Cdata_Section (Doc : Document; Data : DOM_String)
return Cdata_Section;
-- Create a Cdata section for a specific string
-- Not_Supported_Err is raised for HTML documents
function Create_Processing_Instruction
(Doc : Document; Target : DOM_String; Data : DOM_String)
return Processing_Instruction;
-- Create a processing instruction.
-- Invalid_Character_Err raised if Target is invalid.
-- Not_Supported_Err raised for HTML documents
function Create_Attribute (Doc : Document; Name : DOM_String)
return Attr;
-- Create a new attribute.
-- Use Set_Attribute to associate it with an element.
-- See Create_Attribute_NS to create an attribute with a namespace.
-- Invalid_Character_Err raised if Name is invalid
function Create_Attribute_NS
(Doc : Document;
Namespace_URI : DOM_String;
Qualified_Name : DOM_String) return Attr;
function Create_Attribute_NS
(Doc : Document;
Symbols : Sax.Utils.Symbol_Table;
Namespace_URI : Sax.Symbols.Symbol;
Prefix : Sax.Symbols.Symbol;
Local_Name : Sax.Symbols.Symbol) return Attr;
-- Create a new attribute.
-- Use Set_Attribute to associate it with an element.
-- Invalid_Character_Err raised if Name is invalid
-- Namespace_Err raised if Qualified_Name is incorrect.
function Create_Entity_Reference (Doc : Document; Name : DOM_String)
return Entity_Reference;
-- Create a new entity reference.
-- If the referenced entity is known, the child list of the entity
-- reference is made the same as that of the Entity.
-- Invalid_Character_Err raised if Target is invalid.
-- Not_Supported_Err raised for HTML documents
function Get_Elements_By_Tag_Name
(Doc : Document; Tag_Name : DOM_String := "*") return Node_List;
-- Returns a NodeList of all the Elements with a given tag name in the
-- order in which they would be encountered in a preorder traversal
-- of the Document tree.
-- The special case "*" matches all tags.
-- The returned list must be freed with DOM.Core.Free
function Get_Elements_By_Tag_Name_NS
(Doc : Document;
Namespace_URI : DOM_String := "*";
Local_Name : DOM_String := "*") return Node_List;
-- Returns a NodeList of all the matching Elements.
-- "*" matches all namespaces or all local names
-- The returned list must be freed with DOM.Core.Free
function Get_Element_By_Id
(Doc : Document; Element_Id : DOM_String) return Node;
-- Return the element whose id is Element_Id. The first matching element
-- is returned.
-- The DOM implementation must know which attributes are of type Id, or
-- null is returned.
-- For documents resulting from parsing an XML input source, this will only
-- work if the parser was configured with validation features on.
-- Otherwise, it will not know what attributes should be considered as ID,
-- and thus will not be able to retrieve them.
function Adopt_Node (Doc : Document; Source : Node) return Node;
-- Attempts to adopt a node from another document to this document. If
-- supported, it changes the Owner_Document of the source node, its
-- children, as well as the attached attribute nodes if there are any. If
-- the source node has a parent it is first removed from the child list of
-- its parent. This effectively allows moving a subtree from one document
-- to another (unlike Import_Node which create a copy of the source node
-- instead of moving it). When it fails, applications should use
-- Import_Node instead.
--
-- Note that if the adopted node is already part of this document (i.e. the
-- source and target document are the same), this method still has the
-- effect of removing the source node from the child list of its parent, if
-- any. The following list describes the specifics for each type of node.
function Import_Node
(Doc : Document; Imported_Node : Node; Deep : Boolean := True)
return Node;
-- Imports a copy of Import_Node into Doc.
-- It returns the imported node.
-- This behaves mostly as if there had been a merge of the two XML
-- files that contained the document and the imported node, but also takes
-- into account the possibly different DTDs.
end DOM.Core.Documents;
|