casa::LargeRegularFileIO Class Reference
[IO]

#include <LargeRegularFileIO.h>

Inheritance diagram for casa::LargeRegularFileIO:

Inheritance graph
[legend]
Collaboration diagram for casa::LargeRegularFileIO:

Collaboration graph
[legend]
List of all members.

Detailed Description

Class for IO on a regular large file.

Intended use:

Part of API

Review Status

Reviewed By:
Friso Olnon
Date Reviewed:
1996/11/06
Test programs:
tByteIO

Prerequisite

Synopsis

This class is a specialization of class ByteIO . It uses a regular file as the data store.

The class is derived from FilebufIO , which contains all functions to access the file. The description of this class explains the use of the filebufSize argument in the constructor.

Example

       // Create a file (which should not exist yet).
       LargeRegularFileIO regio (RegularFile("file.name"), ByeIO::NewNoReplace);
       // Use that as the sink of AipsIO.
       AipsIO stream (&regio);
       // Write values.
       stream << (Int)10;
       stream << True;
       // Seek to beginning of file and read data in.
       stream.setpos (0);
       Int vali;
       Bool valb;
       stream >> vali >> valb;

Definition at line 81 of file LargeRegularFileIO.h.

Public Member Functions

 LargeRegularFileIO (const RegularFile &regularFile, ByteIO::OpenOption=ByteIO::Old, uInt filebufSize=0)
 Create an IO stream object for a regular file with the given name.
 ~LargeRegularFileIO ()
virtual void reopenRW ()
 Reopen the underlying file for read/write access.
virtual String fileName () const
 Get the file name of the file attached.

Private Member Functions

 LargeRegularFileIO (const LargeRegularFileIO &that)
 Copy constructor, should not be used.
LargeRegularFileIOoperator= (const LargeRegularFileIO &that)
 Assignment, should not be used.

Private Attributes

OpenOption itsOption
RegularFile itsRegularFile


Constructor & Destructor Documentation

casa::LargeRegularFileIO::LargeRegularFileIO ( const RegularFile regularFile,
ByteIO::OpenOption  = ByteIO::Old,
uInt  filebufSize = 0 
) [explicit]

Create an IO stream object for a regular file with the given name.

The ByteIO option determines if the file will be created or opened for input and/or output.
The argument filebufSize defines the length of the internal buffer in the underlying FilebufIO object. A zero length uses an appropriate default.

casa::LargeRegularFileIO::~LargeRegularFileIO (  ) 

casa::LargeRegularFileIO::LargeRegularFileIO ( const LargeRegularFileIO that  )  [private]

Copy constructor, should not be used.


Member Function Documentation

virtual void casa::LargeRegularFileIO::reopenRW (  )  [virtual]

Reopen the underlying file for read/write access.

Nothing will be done if the stream is writable already. Otherwise it will be reopened and an exception will be thrown if it is not possible to reopen it for read/write access.

Reimplemented from casa::ByteIO.

Referenced by casa::StManArrayFile::reopenRW().

virtual String casa::LargeRegularFileIO::fileName (  )  const [virtual]

Get the file name of the file attached.

Reimplemented from casa::LargeFilebufIO.

LargeRegularFileIO& casa::LargeRegularFileIO::operator= ( const LargeRegularFileIO that  )  [private]

Assignment, should not be used.


Member Data Documentation

OpenOption casa::LargeRegularFileIO::itsOption [private]

Definition at line 107 of file LargeRegularFileIO.h.

RegularFile casa::LargeRegularFileIO::itsRegularFile [private]

Definition at line 108 of file LargeRegularFileIO.h.


The documentation for this class was generated from the following file:
Generated on Mon Sep 1 22:44:10 2008 for NRAOCASA by  doxygen 1.5.1