diff options
author | Serhiy Storchaka <storchaka@gmail.com> | 2013-11-16 11:04:00 (GMT) |
---|---|---|
committer | Serhiy Storchaka <storchaka@gmail.com> | 2013-11-16 11:04:00 (GMT) |
commit | 7714ebbe0e7556bbfa6b768e434042b55474939c (patch) | |
tree | edfc3e4daeaca4f88a3efb384c1a34bdf7f808b1 /Doc | |
parent | a7a34a83f3f2b9b319cb6f379f6e189066233c76 (diff) | |
download | cpython-7714ebbe0e7556bbfa6b768e434042b55474939c.zip cpython-7714ebbe0e7556bbfa6b768e434042b55474939c.tar.gz cpython-7714ebbe0e7556bbfa6b768e434042b55474939c.tar.bz2 |
Issue #5202: Added support for unseekable files in the wave module.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/wave.rst | 10 |
1 files changed, 7 insertions, 3 deletions
diff --git a/Doc/library/wave.rst b/Doc/library/wave.rst index 9d12455..189f21a 100644 --- a/Doc/library/wave.rst +++ b/Doc/library/wave.rst @@ -19,7 +19,7 @@ The :mod:`wave` module defines the following function and exception: .. function:: open(file, mode=None) If *file* is a string, open the file by that name, otherwise treat it as a - seekable file-like object. *mode* can be: + file-like object. *mode* can be: ``'rb'`` Read only mode. @@ -43,6 +43,8 @@ The :mod:`wave` module defines the following function and exception: <wave.Wave_read.close>` or :meth:`Wave_write.close() <wave.Wave_write.close()>` method is called. + .. versionchanged:: 3.4 + Added support for unseekable files. .. function:: openfp(file, mode) @@ -154,7 +156,8 @@ Wave_write objects, as returned by :func:`.open`, have the following methods: .. method:: Wave_write.close() Make sure *nframes* is correct, and close the file if it was opened by - :mod:`wave`. This method is called upon object collection. + :mod:`wave`. This method is called upon object collection. Can raise an + exception if *nframes* is not correct and a file is not seekable. .. method:: Wave_write.setnchannels(n) @@ -208,7 +211,8 @@ Wave_write objects, as returned by :func:`.open`, have the following methods: .. method:: Wave_write.writeframes(data) - Write audio frames and make sure *nframes* is correct. + Write audio frames and make sure *nframes* is correct. Can raise an + exception if a file is not seekable. Note that it is invalid to set any parameters after calling :meth:`writeframes` |