DataMuseum.dk

Presents historical artifacts from the history of:

Rational R1000/400

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about Rational R1000/400

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - download

⟦6bc16cfb3⟧ Ada Source

    Length: 5120 (0x1400)
    Types: Ada Source
    Notes: 03_class, FILE, R1k_Segment, e3_tag, package Low_Level_File_Operations, seg_004673

Derivation

└─⟦8527c1e9b⟧ Bits:30000544 8mm tape, Rational 1000, Arrival backup of disks in PAM's R1000
    └─ ⟦5a81ac88f⟧ »Space Info Vol 1« 
        └─⟦this⟧ 

E3 Source Code



--| @SUMMARY This package provides cleaner versions of the file
--| opening/creating operations in the "Io" package.
--|
--| @INDICES (Text_Processing, Utility)
--|
with Io;
package Low_Level_File_Operations is

    --| @SUMMARY Creates a file.
    --|
    --| @RAISES Io_Failure (if the creation attempt fails for some reason).
    --|
    --| @SPECIAL_NOTES If the specified file already exists, does nothing.
    --|
    --| If the specified file does not already exist, creates it.
    --|
    procedure Create (This_File : in String);

    --| @SUMMARY Attempts to open the specified file for reading and return
    --| a pointer to it.
    --|
    --| @RAISES Io_Failure (if the attempt fails for some reason).
    --|
    function Open_To_Read  
                (This_File : in String) return Io.File_Type;

    --| @SUMMARY Attempts to open the specified file for reading.
    --|
    --| @RAISES Io_Failure (if the attempt fails for some reason).
    --|
    procedure Open_To_Read  
                 (This_File : in String; The_File : out Io.File_Type);

    --| @SUMMARY Attempts to open the specified file for writing and return
    --| a pointer to it.
    --|
    --| @RAISES Io_Failure (if the attempt fails for some reason).
    --|
    --| @SPECIAL_NOTES Any pre-existing contents of the file are overwritten.
    --|
    function Open_To_Write  
                (This_File : in String) return Io.File_Type;

    --| @SUMMARY Attempts to open the specified file for writing.
    --|
    --| @RAISES Io_Failure (if the attempt fails for some reason).
    --|
    --| @SPECIAL_NOTES Any pre-existing contents of the file are overwritten.
    --|
    procedure Open_To_Write  
                 (This_File : in String; The_File : out Io.File_Type);

    --| @SUMMARY Attempts to open the specified file for appending and return
    --| a pointer to it.
    --|
    --| @RAISES Io_Failure (if the attempt fails for some reason).
    --|
    --| @SPECIAL_NOTES If the file does not exist, attempts to create it.
    --|
    function Open_To_Append  
                (This_File : in String) return Io.File_Type;

    --| @SUMMARY Attempts to open the specified file for appending.
    --|
    --| @RAISES Io_Failure (if the attempt fails for some reason).
    --|
    --| @SPECIAL_NOTES If the file does not exist, attempts to create it.
    --|
    procedure Open_To_Append  
                 (This_File : in String; The_File : out Io.File_Type);

    --| @SUMMARY Attempts to close the specified file.
    --|
    --| @SPECIAL_NOTES If the file is not open or doesn't exist, has
    --| no effect.
    --|
    procedure Close  
                 (This_File : in out Io.File_Type);

    --| @SUMMARY Attempts to destroy the specified file.
    --|
    --| @SPECIAL_NOTES If the file is not open or doesn't exist, has
    --| no effect.
    --|
    procedure Destroy (This_File : in out Io.File_Type);

    --| @SUMMARY Attempts to destroy the specified file.
    --|
    --| @SPECIAL_NOTES If the file is not open or doesn't exist, has
    --| no effect.
    --|
    procedure Destroy (This_File : in String);

    Io_Failure : exception;

end Low_Level_File_Operations;

E3 Meta Data

    nblk1=4
    nid=0
    hdr6=8
        [0x00] rec0=1e rec1=00 rec2=01 rec3=084
        [0x01] rec0=1b rec1=00 rec2=02 rec3=05e
        [0x02] rec0=1d rec1=00 rec2=03 rec3=034
        [0x03] rec0=0c rec1=00 rec2=04 rec3=000
    tail 0x2150045e6815c666b6758 0x42a00088462061e03