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
|
------------------------------------------------------------------------------
-- 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/>. --
-- --
------------------------------------------------------------------------------
with Unicode;
with Unicode.CES;
package Input_Sources.File is
type File_Input is new Input_Source with private;
type File_Input_Access is access all File_Input'Class;
-- A special implementation of a reader, that reads from a file.
procedure Open (Filename : String; Input : out File_Input'Class);
-- Open a new file for reading.
-- Note that the file is read completly at once, and saved in memory.
-- This provides a much better access later on, however this might be a
-- problem for very big files.
-- The physical file on disk can be modified at any time afterwards, since
-- it is no longer read.
-- This function can decode a file if it is coded in Utf8, Utf16 or Utf32
-- This function must raise Name_Error if the file does not exist
--
-- This function will raise Mismatching_BOM if there are multiple
-- Byte-Order-Marks at the beginning of the file, and they do not match.
Mismatching_BOM : exception;
-- see Open
procedure Close (Input : in out File_Input);
-- Close the file and free the memory
procedure Next_Char
(From : in out File_Input;
C : out Unicode.Unicode_Char);
-- Return the next character in the file.
function Eof (From : File_Input) return Boolean;
-- True if From is past the last character in the file.
procedure Set_System_Id
(Input : in out File_Input; Id : Unicode.CES.Byte_Sequence);
-- Override Input_Sources.Set_System_Id, and ensure we use an absolute
-- file name. This is needed in lots of cases, for instance to resolve
-- relative URIs, to ensure we do not parse a grammar twice,...
private
type File_Input is new Input_Source with
record
Index : Natural;
Buffer : Unicode.CES.Byte_Sequence_Access;
end record;
end Input_Sources.File;
|