casacore
Loading...
Searching...
No Matches
casacore::ByteSource Class Reference

More...

#include <ByteSource.h>

Public Member Functions

 ByteSource ()
 Default constructor.
 
 ByteSource (const std::shared_ptr< TypeIO > &typeIO)
 Construct from given TypeIO object.
 
 ByteSource (const ByteSource &source)
 The copy constructor uses reference semantics.
 
ByteSourceoperator= (const ByteSource &source)
 The assignment operator uses reference semantics.
 
 ~ByteSource ()
 destructor
 
ByteSourceoperator>> (Bool &value)
 These functions read one value of the given type.
 
ByteSourceoperator>> (Char &value)
 
ByteSourceoperator>> (uChar &value)
 
ByteSourceoperator>> (Short &value)
 
ByteSourceoperator>> (uShort &value)
 
ByteSourceoperator>> (Int &value)
 
ByteSourceoperator>> (uInt &value)
 
ByteSourceoperator>> (Int64 &value)
 
ByteSourceoperator>> (uInt64 &value)
 
ByteSourceoperator>> (Float &value)
 
ByteSourceoperator>> (Double &value)
 
ByteSourceoperator>> (Complex &value)
 
ByteSourceoperator>> (DComplex &value)
 
ByteSourceoperator>> (String &value)
 
void read (size_t nvalues, Bool *value)
 These functions read multiple values of the given type.
 
void read (size_t nvalues, Char *value)
 
void read (size_t nvalues, uChar *value)
 
void read (size_t nvalues, Short *value)
 
void read (size_t nvalues, uShort *value)
 
void read (size_t nvalues, Int *value)
 
void read (size_t nvalues, uInt *value)
 
void read (size_t nvalues, Int64 *value)
 
void read (size_t nvalues, uInt64 *value)
 
void read (size_t nvalues, Float *value)
 
void read (size_t nvalues, Double *value)
 
void read (size_t nvalues, Complex *value)
 
void read (size_t nvalues, DComplex *value)
 
void read (size_t nvalues, String *value)
 
- Public Member Functions inherited from casacore::BaseSinkSource
const std::shared_ptr< TypeIO > & typeIO () const
 This functions returns the shared pointer to itsTypeIO.
 
Int64 seek (Int64 offset, ByteIO::SeekOption=ByteIO::Begin)
 This function sets the position on the given offset.
 
Int64 seek (Int offset, ByteIO::SeekOption=ByteIO::Begin)
 
Bool isReadable () const
 Is the SinkSource readable?
 
Bool isWritable () const
 Is the SinkSource writable?
 
Bool isSeekable () const
 Is the SinkSource seekable?
 
Bool isNull () const
 Is the BaseSinkSource unusable?

 

Additional Inherited Members

- Protected Member Functions inherited from casacore::BaseSinkSource
 BaseSinkSource ()
 
 BaseSinkSource (const std::shared_ptr< TypeIO > &typeIO)
 Construct using the given TypeIO.
 
 BaseSinkSource (const BaseSinkSource &BaseSinkSource)
 The copy constructor uses reference semantics.
 
BaseSinkSourceoperator= (const BaseSinkSource &BaseSinkSource)
 The assignment operator uses reference semantics.
 
virtual ~BaseSinkSource ()
 
- Protected Attributes inherited from casacore::BaseSinkSource
std::shared_ptr< TypeIOitsTypeIO
 This variable keeps a pointer to a TypeIO.
 

Detailed Description

Class for read-only access to data in a given format.

Intended use:

Public interface

Review Status

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

Prerequisite

Etymology

A source is the place where bytes are read from.

Synopsis

ByteSource provides read-only access to a typed byte stream in the Casacore IO framework. The base class BaseSinkSource contains common functions like seek.

The object is constructed using a typed byte stream. This stream is an instance of a class derived from class TypeIO. This makes it possible to read the data in any format (e.g. CanonicalIO or RawIO).
In its turn TypeIO uses an instance of a class derived from class ByteIO. This makes it possible to use any input stream (e.g. file, memory).

Example

// Construct the correct input stream.
RegularFileIO filio ("file.name");
CanonicalIO canio (&filio);
ByteSource source (&canio);
// Read data.
Int vali;
Bool flag;
source >> vali >> flag;
int Int
Definition aipstype.h:48
bool Bool
Define the standard types used by Casacore.
Definition aipstype.h:40

Motivation

This class makes it possible to deny write-access to an IO stream.

Definition at line 89 of file ByteSource.h.

Constructor & Destructor Documentation

◆ ByteSource() [1/3]

casacore::ByteSource::ByteSource ( )

Default constructor.

This creates an invalid object, but is present for convenience.

◆ ByteSource() [2/3]

casacore::ByteSource::ByteSource ( const std::shared_ptr< TypeIO > & typeIO)

Construct from given TypeIO object.

The constructor does not copy the object, but only keeps a pointer to it.

◆ ByteSource() [3/3]

casacore::ByteSource::ByteSource ( const ByteSource & source)

The copy constructor uses reference semantics.

◆ ~ByteSource()

casacore::ByteSource::~ByteSource ( )

destructor

Member Function Documentation

◆ operator=()

ByteSource & casacore::ByteSource::operator= ( const ByteSource & source)

The assignment operator uses reference semantics.

◆ operator>>() [1/14]

ByteSource & casacore::ByteSource::operator>> ( Bool & value)

These functions read one value of the given type.

If this function does not succeed, an exception will be thrown.

◆ operator>>() [2/14]

ByteSource & casacore::ByteSource::operator>> ( Char & value)

◆ operator>>() [3/14]

ByteSource & casacore::ByteSource::operator>> ( Complex & value)

◆ operator>>() [4/14]

ByteSource & casacore::ByteSource::operator>> ( DComplex & value)

◆ operator>>() [5/14]

ByteSource & casacore::ByteSource::operator>> ( Double & value)

◆ operator>>() [6/14]

ByteSource & casacore::ByteSource::operator>> ( Float & value)

◆ operator>>() [7/14]

ByteSource & casacore::ByteSource::operator>> ( Int & value)

◆ operator>>() [8/14]

ByteSource & casacore::ByteSource::operator>> ( Int64 & value)

◆ operator>>() [9/14]

ByteSource & casacore::ByteSource::operator>> ( Short & value)

◆ operator>>() [10/14]

ByteSource & casacore::ByteSource::operator>> ( String & value)

◆ operator>>() [11/14]

ByteSource & casacore::ByteSource::operator>> ( uChar & value)

◆ operator>>() [12/14]

ByteSource & casacore::ByteSource::operator>> ( uInt & value)

◆ operator>>() [13/14]

ByteSource & casacore::ByteSource::operator>> ( uInt64 & value)

◆ operator>>() [14/14]

ByteSource & casacore::ByteSource::operator>> ( uShort & value)

◆ read() [1/14]

void casacore::ByteSource::read ( size_t nvalues,
Bool * value )

These functions read multiple values of the given type.

If this function does not succeed, an exception will be thrown.

◆ read() [2/14]

void casacore::ByteSource::read ( size_t nvalues,
Char * value )

◆ read() [3/14]

void casacore::ByteSource::read ( size_t nvalues,
Complex * value )

◆ read() [4/14]

void casacore::ByteSource::read ( size_t nvalues,
DComplex * value )

◆ read() [5/14]

void casacore::ByteSource::read ( size_t nvalues,
Double * value )

◆ read() [6/14]

void casacore::ByteSource::read ( size_t nvalues,
Float * value )

◆ read() [7/14]

void casacore::ByteSource::read ( size_t nvalues,
Int * value )

◆ read() [8/14]

void casacore::ByteSource::read ( size_t nvalues,
Int64 * value )

◆ read() [9/14]

void casacore::ByteSource::read ( size_t nvalues,
Short * value )

◆ read() [10/14]

void casacore::ByteSource::read ( size_t nvalues,
String * value )

◆ read() [11/14]

void casacore::ByteSource::read ( size_t nvalues,
uChar * value )

◆ read() [12/14]

void casacore::ByteSource::read ( size_t nvalues,
uInt * value )

◆ read() [13/14]

void casacore::ByteSource::read ( size_t nvalues,
uInt64 * value )

◆ read() [14/14]

void casacore::ByteSource::read ( size_t nvalues,
uShort * value )

The documentation for this class was generated from the following file: