CDPL.Util.BZip2IOStream Class Reference

Bidirectional stream that transparently (de)compresses bzip2 data. More...

Inheritance diagram for CDPL.Util.BZip2IOStream:

Public Member Functions
None	__init__ ()
	Contructs the BZip2IOStream instance.
None	__init__ (Base.IOStream ios)
	Constructs a BZip2IOStream instance that will read/write the compressed data from/to the I/O stream ios. More...
str	readline (int size=-1)
	Reads one entire line. More...
list	readlines (int size=-1)
	Reads lines until EOF and returns a list containing the lines thus read. More...
BZip2IOStream	xreadlines ()
	Returns the stream instance. More...
str	read (int size=-1)
	Reads at most size bytes. More...
int	tell ()
	Returns the current read position. More...
int	tellr ()
	Returns the current read position. More...
None	seek (int offs, int whence=0)
	Sets the current read position. More...
None	seekr (int offs, int whence=0)
	Sets the current read position. More...
str	next ()
	Reads and returns the next line. More...
bool	isClosed ()
	Tells whether the stream has been closed. More...
str	getOpenModeString ()
	Returns the open mode string that was provided as argument to the constructor. More...
OpenMode	getOpenModeFlags ()
	Returns the open mode flags that were provided as argument to the constructor. More...
None	flush ()
	Flushes the internal buffer.
None	write (object string)
	Outputs the specified string. More...
None	writelines (object iterable)
	Outputs the specified sequence of strings. More...
int	tellw ()
	Returns the current write position. More...
None	seekw (int offs, int whence=0)
	Sets the current write position. More...
bool	getSoftSpace ()
	Returns a boolean that indicates whether a space character needs to be printed before another value when using the print statement. More...
None	setSoftSpace (bool value)
	Sets a boolean that indicates whether a space character needs to be printed before another value when using the print statement. More...
None	close ()
	Closes the stream. More...
None	open (Base.IOStream ios)
	Sets the I/O stream that receives/provides the compressed data. More...
BZip2IOStream	__iter__ ()
	Returns the stream instance. More...
Public Member Functions inherited from CDPL.Base.IStream
int	getObjectID ()
	Returns the numeric identifier (ID) of the wrapped C++ class instance. More...
Public Member Functions inherited from CDPL.Base.OStream
int	getObjectID ()
	Returns the numeric identifier (ID) of the wrapped C++ class instance. More...

Properties
	closed = property(isClosed)
	mode = property(getOpenModeString)
	modeFlags = property(getOpenModeFlags)
	softspace = property(getSoftSpace, setSoftSpace)
Properties inherited from CDPL.Base.IStream
	objectID = property(getObjectID)
Properties inherited from CDPL.Base.OStream
	objectID = property(getObjectID)

Additional Inherited Members
Static Public Attributes inherited from CDPL.Base.IStream
	STD_IN = _HIDDEN_VALUE_
	The standard input stream of the current process.
Static Public Attributes inherited from CDPL.Base.OStream
	STD_OUT = _HIDDEN_VALUE_
	The standard output stream of the current process.
	STD_ERR = _HIDDEN_VALUE_
	The standard error stream of the current process.

Detailed Description

Bidirectional stream that transparently (de)compresses bzip2 data.

Constructor & Destructor Documentation

__init__()

None CDPL.Util.BZip2IOStream.__init__

(

Base.IOStream

ios

)

Constructs a BZip2IOStream instance that will read/write the compressed data from/to the I/O stream ios.

Parameters

ios	The I/O stream to read from/write to.

Member Function Documentation

readline()

str CDPL.Util.BZip2IOStream.readline

(

int

size = -1

)

Reads one entire line.

A trailing newline character is kept in the string (but may be absent when a file ends with an incomplete line). If the size argument is present and non-negative, it is a maximum byte count (including the trailing newline) and an incomplete line may be returned. When size is not 0, an empty string is returned only if EOF is encountered immediately.

Parameters

size	If present and non-negative, specifies the maximum number of bytes to read (including the trailing newline).

Returns

A string holding the read line.

readlines()

list CDPL.Util.BZip2IOStream.readlines

(

int

size = -1

)

Reads lines until EOF and returns a list containing the lines thus read.

If the optional size argument is present and non-negative, instead of reading up to EOF, whole lines totalling approximately size bytes are read.

Parameters

size	If present and non-negative, specifies the maximum number of bytes to read.

Returns

A list containing the read lines.

xreadlines()

BZip2IOStream CDPL.Util.BZip2IOStream.xreadlines

(

)

Returns the stream instance.

Returns

self.

read()

str CDPL.Util.BZip2IOStream.read

(

int

size = -1

)

Reads at most size bytes.

If the size argument is negative or omitted, all data until EOF is reached are read. The bytes are returned as a string object. An empty string is returned when EOF is encountered immediately.

Parameters

size	If present and non-negative, specifies the maximum number of bytes to read.

Returns

A string containing the read data.

tell()

int CDPL.Util.BZip2IOStream.tell

(

)

Returns the current read position.

Returns

The current read position.

tellr()

int CDPL.Util.BZip2IOStream.tellr

(

)

Returns the current read position.

Returns

The current read position.

seek()

None CDPL.Util.BZip2IOStream.seek	(	int	offs,
		int	whence = 0
	)

Sets the current read position.

The whence argument is optional and defaults to 0 (absolute positioning). Other supported values are 1 to seek relative to the current position and 2 for seeking relative to the end of input.

Parameters

offs	The offset to use for the seek operation.
whence	Value specifying how to calculate the final read position.

seekr()

None CDPL.Util.BZip2IOStream.seekr	(	int	offs,
		int	whence = 0
	)

Sets the current read position.

The whence argument is optional and defaults to 0 (absolute positioning). Other supported values are 1 to seek relative to the current position and 2 for seeking relative to the end of input.

Parameters

offs	The offset to use for the seek operation.
whence	Value specifying how to calculate the final read position.

next()

str CDPL.Util.BZip2IOStream.next

(

)

Reads and returns the next line.

A stream object is its own iterator, for example iter(s) returns s. When a stream is used as an iterator, typically in a for loop (for example, for line in s: print line.strip()), the next() method is called repeatedly. This method returns the next input line, or raises StopIteration when EOF is hit when the stream is open for reading (when the stream has been opened for writing only then Base.IOError is raised).

Returns

A string holding the read line.

isClosed()

bool CDPL.Util.BZip2IOStream.isClosed

(

)

Tells whether the stream has been closed.

See also

close()

getOpenModeString()

str CDPL.Util.BZip2IOStream.getOpenModeString

(

)

Returns the open mode string that was provided as argument to the constructor.

Returns

The open mode string (e.g. 'r+') that was provided as argument to the constructor.

getOpenModeFlags()

OpenMode CDPL.Util.BZip2IOStream.getOpenModeFlags

(

)

Returns the open mode flags that were provided as argument to the constructor.

Returns

The open mode flags that were provided as argument to the constructor (see Stream.OpenMode).

write()

None CDPL.Util.BZip2IOStream.write

(

object

string

)

Outputs the specified string.

Parameters

string

The string to output.

Note

Due to buffering, the string may not actually show up in the file until the flush() or close() method is called.

writelines()

None CDPL.Util.BZip2IOStream.writelines

(

object

iterable

)

Outputs the specified sequence of strings.

Parameters

iterable

The string sequence to output (can be any iterable object producing strings, typically a list of strings).

tellw()

int CDPL.Util.BZip2IOStream.tellw

(

)

Returns the current write position.

Returns

The current write position.

seekw()

None CDPL.Util.BZip2IOStream.seekw	(	int	offs,
		int	whence = 0
	)

Sets the current write position.

The whence argument is optional and defaults to 0 (absolute positioning). Other supported values are 1 to seek relative to the current position and 2 for seeking relative to the end of input.

Parameters

offs	The offset to use for the seek operation.
whence	Value specifying how to calculate the final write position.

getSoftSpace()

bool CDPL.Util.BZip2IOStream.getSoftSpace

(

)

Returns a boolean that indicates whether a space character needs to be printed before another value when using the print statement.

Returns

True if a space character needs to be printed before another value when using the print statement, and False otherwise.

setSoftSpace()

None CDPL.Util.BZip2IOStream.setSoftSpace

(

bool

value

)

Sets a boolean that indicates whether a space character needs to be printed before another value when using the print statement.

Parameters

value

True if a space character shall be printed before another value when using the print statement, and False otherwise.

close()

None CDPL.Util.BZip2IOStream.close

(

)

Closes the stream.

A closed stream cannot be read from or written to anymore. Any operation which requires the stream to be open will raise a Base.ValueError after the stream has been closed. Calling close() more than once is allowed.

open()

None CDPL.Util.BZip2IOStream.open

(

Base.IOStream

ios

)

Sets the I/O stream that receives/provides the compressed data.

Parameters

ios	The new I/O stream to read from/write to.

__iter__()

BZip2IOStream CDPL.Util.BZip2IOStream.__iter__

(

)

Returns the stream instance.

Returns

self.