home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / gnat-2.06-src.tgz / tar.out / fsf / gnat / ada / a-direio.ads < prev    next >
Text File  |  1996-09-28  |  5KB  |  139 lines
  1. ------------------------------------------------------------------------------
  2. --                                                                          --
  3. --                         GNAT RUNTIME COMPONENTS                          --
  4. --                                                                          --
  5. --                        A D A . D I R E C T _ I O                         --
  6. --                                                                          --
  7. --                                 S p e c                                  --
  8. --                                                                          --
  9. --                            $Revision: 1.11 $                             --
  10. --                                                                          --
  11. -- This specification is adapted from the Ada Reference Manual for use with --
  12. -- GNAT.  In accordance with the copyright of that document, you can freely --
  13. -- copy and modify this specification,  provided that if you redistribute a --
  14. -- modified version,  any changes that you have made are clearly indicated. --
  15. --                                                                          --
  16. ------------------------------------------------------------------------------
  17.  
  18.  
  19. with Ada.IO_Exceptions;
  20. with System.Direct_IO;
  21.  
  22. generic
  23.    type Element_Type is private;
  24.  
  25. package Ada.Direct_IO is
  26.  
  27.    type File_Type is limited private;
  28.  
  29.    type File_Mode is (In_File, Inout_File, Out_File);
  30.  
  31.    type Count is new System.Direct_IO.Count;
  32.  
  33.    subtype Positive_Count is Count range 1 .. Count'Last;
  34.  
  35.    ---------------------
  36.    -- File Management --
  37.    ---------------------
  38.  
  39.    procedure Create
  40.      (File : in out File_Type;
  41.       Mode : in File_Mode := Inout_File;
  42.       Name : in String := "";
  43.       Form : in String := "");
  44.  
  45.    procedure Open
  46.      (File : in out File_Type;
  47.       Mode : in File_Mode;
  48.       Name : in String;
  49.       Form : in String := "");
  50.  
  51.    procedure Close  (File : in out File_Type);
  52.    procedure Delete (File : in out File_Type);
  53.    procedure Reset  (File : in out File_Type; Mode : in File_Mode);
  54.    procedure Reset  (File : in out File_Type);
  55.  
  56.    function Mode (File : in File_Type) return File_Mode;
  57.    function Name (File : in File_Type) return String;
  58.    function Form (File : in File_Type) return String;
  59.  
  60.    function Is_Open (File : in File_Type) return Boolean;
  61.  
  62.    ---------------------------------
  63.    -- Input and Output Operations --
  64.    ---------------------------------
  65.  
  66.    procedure Read
  67.      (File : in File_Type;
  68.       Item : out Element_Type;
  69.       From : in Positive_Count);
  70.  
  71.    procedure Read
  72.      (File : in File_Type;
  73.       Item : out Element_Type);
  74.  
  75.    procedure Write
  76.      (File : in File_Type;
  77.       Item : in Element_Type;
  78.       To   : in Positive_Count);
  79.  
  80.    procedure Write
  81.      (File : in File_Type;
  82.       Item : in Element_Type);
  83.  
  84.    procedure Set_Index (File : in File_Type; To : in Positive_Count);
  85.  
  86.    function Index (File : in File_Type) return Positive_Count;
  87.    function Size  (File : in File_Type) return Count;
  88.  
  89.    function End_Of_File (File : in File_Type) return Boolean;
  90.  
  91.    ----------------
  92.    -- Exceptions --
  93.    ----------------
  94.  
  95.    Status_Error : exception renames IO_Exceptions.Status_Error;
  96.    Mode_Error   : exception renames IO_Exceptions.Mode_Error;
  97.    Name_Error   : exception renames IO_Exceptions.Name_Error;
  98.    Use_Error    : exception renames IO_Exceptions.Use_Error;
  99.    Device_Error : exception renames IO_Exceptions.Device_Error;
  100.    End_Error    : exception renames IO_Exceptions.End_Error;
  101.    Data_Error   : exception renames IO_Exceptions.Data_Error;
  102.  
  103. private
  104.    type File_Type is new System.Direct_IO.File_Type;
  105.  
  106.    --  The following representation clause allows the use of unchecked
  107.    --  conversion for rapid translation between the File_Mode type
  108.    --  used in this package and System.File_IO.
  109.  
  110.    for File_Mode use
  111.      (In_File     => 0,   -- System.Fole_IO.File_Mode'Pos (In_File)
  112.       Inout_File  => 1,   -- System.File_IO.File_Mode'Pos (Inout_File);
  113.       Out_File    => 2);  -- System.File_IO.File_Mode'Pos (Out_File)
  114.  
  115.    Bytes : constant Interfaces.C_Streams.size_t :=
  116.              (Element_Type'Size + System.Storage_Unit - 1) /
  117.                                                  System.Storage_Unit;
  118.    --  Size of an element in storage units
  119.  
  120.    --  All routines are inlined
  121.  
  122.    pragma Inline (Close);
  123.    pragma Inline (Create);
  124.    pragma Inline (Delete);
  125.    pragma Inline (End_Of_File);
  126.    pragma Inline (Form);
  127.    pragma Inline (Index);
  128.    pragma Inline (Is_Open);
  129.    pragma Inline (Mode);
  130.    pragma Inline (Name);
  131.    pragma Inline (Open);
  132.    pragma Inline (Read);
  133.    pragma Inline (Reset);
  134.    pragma Inline (Set_Index);
  135.    pragma Inline (Size);
  136.    pragma Inline (Write);
  137.  
  138. end Ada.Direct_IO;
  139.