DcmFileConsumer Class Reference

consumer class that stores data in a plain file. More...

Inheritance diagram for DcmFileConsumer:

Public Member Functions
	DcmFileConsumer (const OFFilename &filename)
	constructor More...
	DcmFileConsumer (FILE *file)
	constructor More...
virtual	~DcmFileConsumer ()
	destructor
virtual OFBool	good () const
	returns the status of the consumer. More...
virtual OFCondition	status () const
	returns the status of the consumer as an OFCondition object. More...
virtual OFBool	isFlushed () const
	returns true if the consumer is flushed, i.e. More...
virtual offile_off_t	avail () const
	returns the minimum number of bytes that can be written with the next call to write(). More...
virtual offile_off_t	write (const void *buf, offile_off_t buflen)
	processes as many bytes as possible from the given input block. More...
virtual void	flush ()
	instructs the consumer to flush its internal content until either the consumer becomes "flushed" or I/O suspension occurs. More...
Public Member Functions inherited from DcmConsumer
virtual	~DcmConsumer ()
	destructor

Private Member Functions
	DcmFileConsumer (const DcmFileConsumer &)
	private unimplemented copy constructor
DcmFileConsumer &	operator= (const DcmFileConsumer &)
	private unimplemented copy assignment operator

Private Attributes
OFFile	file_
	the file we're actually writing to
OFCondition	status_
	status

Detailed Description

consumer class that stores data in a plain file.

Constructor & Destructor Documentation

DcmFileConsumer() [1/2]

DcmFileConsumer::DcmFileConsumer

(

const OFFilename &

filename

)

constructor

Parameters

filename

name of file to be created (may contain wide chars if support enabled)

DcmFileConsumer() [2/2]

DcmFileConsumer::DcmFileConsumer

(

FILE *

file

)

constructor

Parameters

file	structure, file must already be open for writing

Member Function Documentation

avail()

virtual offile_off_t DcmFileConsumer::avail ( ) const

virtual

returns the minimum number of bytes that can be written with the next call to write().

The DcmObject write methods rely on avail to return a value > 0 if there is no I/O suspension since certain data such as tag and length are only written "en bloc", i.e. all or nothing.

Returns

minimum of space available in consumer

Implements DcmConsumer.

flush()

virtual void DcmFileConsumer::flush ( )

virtual

instructs the consumer to flush its internal content until either the consumer becomes "flushed" or I/O suspension occurs.

After a call to flush(), a call to write() will produce undefined behaviour.

Implements DcmConsumer.

good()

virtual OFBool DcmFileConsumer::good ( ) const

virtual

returns the status of the consumer.

Unless the status is good, the consumer will not permit any operation.

Returns

status, true if good

Implements DcmConsumer.

isFlushed()

virtual OFBool DcmFileConsumer::isFlushed ( ) const

virtual

returns true if the consumer is flushed, i.e.

has no more data pending in it's internal state that needs to be flushed before the stream is closed.

Returns

true if consumer is flushed, false otherwise

Implements DcmConsumer.

status()

virtual OFCondition DcmFileConsumer::status ( ) const

virtual

returns the status of the consumer as an OFCondition object.

Unless the status is good, the consumer will not permit any operation.

Returns

status, EC_Normal if good

Implements DcmConsumer.

write()

virtual offile_off_t DcmFileConsumer::write ( const void *  buf, offile_off_t  buflen  )

virtual

processes as many bytes as possible from the given input block.

Parameters

buf	pointer to memory block, must not be NULL
buflen	length of memory block

Returns

number of bytes actually processed.

Implements DcmConsumer.

---

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

• dcmdata/include/dcmtk/dcmdata/dcostrmf.h