ast::StringStream Class Reference

String-based source and sink for channels. More...

#include <Stream.h>

Inheritance diagram for ast::StringStream:

Public Member Functions
	StringStream (std::string const &data="")
	Construct a StringStream. More...
virtual	~StringStream ()
std::string	getSourceData () const
	Get a copy of the text from the sink/output stream, without changing the stream. More...
std::string	getSinkData () const
	Get a copy of the text from the sink/output stream, without changing the stream. More...
void	sinkToSource ()
	Move output/sink data to input/source. More...
bool	hasStdStream ()
	Return true if this Stream has an input or output std::stream. More...
char const *	source ()
	Source (read) from the stream. More...
bool	sink (char const *cstr)
	Sink (write) to the stream. More...
bool	getIsFits () const
	get isfits More...

Protected Member Functions
void	setIsFits (bool isFits)
	set isFits More...

Protected Attributes
std::shared_ptr< std::istream >	_istreamPtr
	input stream More...
std::shared_ptr< std::ostream >	_ostreamPtr
	output stream More...
std::string	_sourceStr
	string containing a local copy of sourced data, so source can return a char * that won't disappear right away More...
bool	_isFits
	is this a FITS stream? More...

Detailed Description

String-based source and sink for channels.

This sources from one stringstream and sinks to another. The data can be retrieved at any time, without affecting the stream, using getData.

Definition at line 180 of file Stream.h.

Constructor & Destructor Documentation

StringStream()

ast::StringStream::StringStream ( std::string const &  data = "" )

inlineexplicit

Construct a StringStream.

Parameters

[in]

data

initial data for the source stream

Definition at line 187 of file Stream.h.

                                                      : Stream(), _istringstreamPtr(), _ostringstreamPtr() {
        _istringstreamPtr = std::make_shared<std::istringstream>(data);
        _ostringstreamPtr = std::make_shared<std::ostringstream>();
        _istreamPtr = _istringstreamPtr;
        _ostreamPtr = _ostringstreamPtr;
    }

~StringStream()

virtual ast::StringStream::~StringStream ( )

inlinevirtual

Definition at line 194 of file Stream.h.

{}

Member Function Documentation

getIsFits()

bool ast::Stream::getIsFits ( ) const

inlineinherited

get isfits

Definition at line 125 of file Stream.h.

{ return _isFits; }

getSinkData()

std::string ast::StringStream::getSinkData ( ) const

inline

Get a copy of the text from the sink/output stream, without changing the stream.

Definition at line 200 of file Stream.h.

{ return _ostringstreamPtr->str(); }

getSourceData()

std::string ast::StringStream::getSourceData ( ) const

inline

Get a copy of the text from the sink/output stream, without changing the stream.

Definition at line 197 of file Stream.h.

{ return _istringstreamPtr->str(); }

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.

{ return _istreamPtr || _ostreamPtr; }

setIsFits()

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

inlineprotectedinherited

set isFits

Definition at line 129 of file Stream.h.

{ _isFits = isFits; }

sink()

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

inlineinherited

Sink (write) to the stream.

Parameters

[in]

cstr

data 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.

                                {
        if (_ostreamPtr) {
            (*_ostreamPtr) << cstr;
            if (!_isFits) {
                (*_ostreamPtr) << std::endl;
            }
            return static_cast<bool>(*_ostreamPtr);
        } else {
            return true;
        }
    }

sinkToSource()

void ast::StringStream::sinkToSource ( )

inline

Move output/sink data to input/source.

Definition at line 203 of file Stream.h.

                        {
        _istringstreamPtr->clear();
        _istringstreamPtr->str(getSinkData());
        _ostringstreamPtr->str("");
    }

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.

                         {
        if ((_istreamPtr) && (*_istreamPtr)) {
            if (_isFits) {
                // http://codereview.stackexchange.com/a/28759
                _sourceStr.resize(detail::FITSLEN);
                _istreamPtr->read(&_sourceStr[0], detail::FITSLEN);
            } else {
                std::getline(*_istreamPtr, _sourceStr);
            }
            if (*_istreamPtr) {
                return _sourceStr.c_str();
            }
        }
        return nullptr;
    }

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:

• /j/snowflake/release/lsstsw/stack/lsst-scipipe-0.7.0/Linux64/astshim/22.0.1-1-geca5380+7fa3b7d9b6/include/astshim/Stream.h