def available(self):
pass<EOL>
Gets the number of ``bytes`` available for retrieval.

        The number returned by this method may be less than or equal to
        the total number of ``bytes`` in this stream.

        return: (cardinal) - the number of ``bytes`` available for
                retrieval
        raise:  IllegalState - this stream has been closed
        *compliance: mandatory -- This method must be implemented.*