LSST Applications 27.0.0,g0265f82a02+469cd937ee,g02d81e74bb+21ad69e7e1,g1470d8bcf6+cbe83ee85a,g2079a07aa2+e67c6346a6,g212a7c68fe+04a9158687,g2305ad1205+94392ce272,g295015adf3+81dd352a9d,g2bbee38e9b+469cd937ee,g337abbeb29+469cd937ee,g3939d97d7f+72a9f7b576,g487adcacf7+71499e7cba,g50ff169b8f+5929b3527e,g52b1c1532d+a6fc98d2e7,g591dd9f2cf+df404f777f,g5a732f18d5+be83d3ecdb,g64a986408d+21ad69e7e1,g858d7b2824+21ad69e7e1,g8a8a8dda67+a6fc98d2e7,g99cad8db69+f62e5b0af5,g9ddcbc5298+d4bad12328,ga1e77700b3+9c366c4306,ga8c6da7877+71e4819109,gb0e22166c9+25ba2f69a1,gb6a65358fc+469cd937ee,gbb8dafda3b+69d3c0e320,gc07e1c2157+a98bf949bb,gc120e1dc64+615ec43309,gc28159a63d+469cd937ee,gcf0d15dbbd+72a9f7b576,gdaeeff99f8+a38ce5ea23,ge6526c86ff+3a7c1ac5f1,ge79ae78c31+469cd937ee,gee10cc3b42+a6fc98d2e7,gf1cff7945b+21ad69e7e1,gfbcc870c63+9a11dc8c8f
LSST Data Management Base Package
Loading...
Searching...
No Matches
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
ast::FileStream Class Reference

File-based source or sink (not both) for channels. More...

#include <Stream.h>

Inheritance diagram for ast::FileStream:
ast::Stream

Public Member Functions

 FileStream (std::string const &path, bool doWrite=false)
 Construct a FileStream for reading or writing, but not both.
 
virtual ~FileStream ()
 
std::string getPath () const
 Get the path to the file, as a string.
 
bool hasStdStream ()
 Return true if this Stream has an input or output std::stream.
 
char const * source ()
 Source (read) from the stream.
 
bool sink (char const *cstr)
 Sink (write) to the stream.
 
bool getIsFits () const
 get isfits
 

Protected Member Functions

void setIsFits (bool isFits)
 set isFits
 

Protected Attributes

std::shared_ptr< std::istream_istreamPtr
 input stream
 
std::shared_ptr< std::ostream_ostreamPtr
 output stream
 
std::string _sourceStr
 string containing a local copy of sourced data, so source can return a char * that won't disappear right away
 
bool _isFits
 is this a FITS stream?
 

Detailed Description

File-based source or sink (not both) for channels.

Definition at line 142 of file Stream.h.

Constructor & Destructor Documentation

◆ FileStream()

ast::FileStream::FileStream ( std::string const & path,
bool doWrite = false )
inlineexplicit

Construct a FileStream for reading or writing, but not both.

Parameters
[in]pathPath to file as a string
[in]doWriteIf true then write to the file, otherwise read from the file

Definition at line 150 of file Stream.h.

150 : Stream(), _path(path) {
151 auto mode = doWrite ? std::ios_base::out : std::ios_base::in;
152 auto fstreamPtr = std::make_shared<std::fstream>(path, mode);
153 if (!*fstreamPtr) {
155 os << "Failed to open file \"" << path << "\" for " << (doWrite ? "writing" : "reading");
156 throw std::runtime_error(os.str());
157 }
158 if (doWrite) {
159 _ostreamPtr = fstreamPtr;
160 } else {
161 _istreamPtr = fstreamPtr;
162 }
163 }
std::ostream * os
Definition Schema.cc:557
std::shared_ptr< std::ostream > _ostreamPtr
output stream
Definition Stream.h:132
std::shared_ptr< std::istream > _istreamPtr
input stream
Definition Stream.h:131

◆ ~FileStream()

virtual ast::FileStream::~FileStream ( )
inlinevirtual

Definition at line 165 of file Stream.h.

165{}

Member Function Documentation

◆ getIsFits()

bool ast::Stream::getIsFits ( ) const
inlineinherited

get isfits

Definition at line 125 of file Stream.h.

125{ return _isFits; }
bool _isFits
is this a FITS stream?
Definition Stream.h:136

◆ getPath()

std::string ast::FileStream::getPath ( ) const
inline

Get the path to the file, as a string.

Definition at line 168 of file Stream.h.

168{ return _path; }

◆ hasStdStream()

bool ast::Stream::hasStdStream ( )
inlineinherited

Return true if this Stream has an input or output std::stream.

Definition at line 73 of file Stream.h.

73{ return _istreamPtr || _ostreamPtr; }

◆ setIsFits()

void ast::Stream::setIsFits ( bool isFits)
inlineprotectedinherited

set isFits

Definition at line 129 of file Stream.h.

129{ _isFits = isFits; }

◆ sink()

bool ast::Stream::sink ( char const * cstr)
inlineinherited

Sink (write) to the stream.

Parameters
[in]cstrdata to write; a newline is then written if _isFits false
Returns
true on success or if there is no stream pointer (a normal mode), false if the stream pointer is in a bad state after writing
Note
this function is not virtual because of type slicing: this function is called from code that casts a void pointer to a Stream pointer without knowing which kind of Stream it is.

Definition at line 110 of file Stream.h.

110 {
111 if (_ostreamPtr) {
112 (*_ostreamPtr) << cstr;
113 if (!_isFits) {
114 (*_ostreamPtr) << std::endl;
115 }
116 return static_cast<bool>(*_ostreamPtr);
117 } else {
118 return true;
119 }
120 }
T endl(T... args)

◆ source()

char const * ast::Stream::source ( )
inlineinherited

Source (read) from the stream.

Returns
the data read as a C string, or nullptr if there is no source stream or the source stream is empty or in an error state. The Stream owns the string buffer, and it will be invalidated on the next call to this function.

Definition at line 84 of file Stream.h.

84 {
85 if ((_istreamPtr) && (*_istreamPtr)) {
86 if (_isFits) {
87 // http://codereview.stackexchange.com/a/28759
88 _sourceStr.resize(detail::FITSLEN);
89 _istreamPtr->read(&_sourceStr[0], detail::FITSLEN);
90 } else {
92 }
93 if (*_istreamPtr) {
94 return _sourceStr.c_str();
95 }
96 }
97 return nullptr;
98 }
T c_str(T... args)
std::string _sourceStr
string containing a local copy of sourced data, so source can return a char * that won't disappear ri...
Definition Stream.h:135
T getline(T... args)
T read(T... args)
T resize(T... args)

Member Data Documentation

◆ _isFits

bool ast::Stream::_isFits
protectedinherited

is this a FITS stream?

Definition at line 136 of file Stream.h.

◆ _istreamPtr

std::shared_ptr<std::istream> ast::Stream::_istreamPtr
protectedinherited

input stream

Definition at line 131 of file Stream.h.

◆ _ostreamPtr

std::shared_ptr<std::ostream> ast::Stream::_ostreamPtr
protectedinherited

output stream

Definition at line 132 of file Stream.h.

◆ _sourceStr

std::string ast::Stream::_sourceStr
protectedinherited

string containing a local copy of sourced data, so source can return a char * that won't disappear right away

Definition at line 135 of file Stream.h.


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