Patch from Sjoerd Mullender:

Make argument names equal to what is used in the documentation of the
file object, since chunks are supposedly file-like.
This commit is contained in:
Fred Drake 1999-06-25 14:58:44 +00:00
parent 59834f11e3
commit 624a191512
1 changed files with 12 additions and 12 deletions

View File

@ -17,7 +17,7 @@ The ID is a 4-byte string which identifies the type of chunk.
The size field (a 32-bit value, encoded using big-endian byte order) The size field (a 32-bit value, encoded using big-endian byte order)
gives the size of the whole chunk, including the 8-byte header. gives the size of the whole chunk, including the 8-byte header.
Usually a IFF-type file consists of one or more chunks. The proposed Usually an IFF-type file consists of one or more chunks. The proposed
usage of the Chunk class defined here is to instantiate an instance at usage of the Chunk class defined here is to instantiate an instance at
the start of each chunk and read from the instance until it reaches the start of each chunk and read from the instance until it reaches
the end, after which a new instance can be instantiated. At the end the end, after which a new instance can be instantiated. At the end
@ -84,7 +84,7 @@ class Chunk:
raise ValueError, "I/O operation on closed file" raise ValueError, "I/O operation on closed file"
return 0 return 0
def seek(self, pos, mode = 0): def seek(self, pos, whence = 0):
"""Seek to specified position into the chunk. """Seek to specified position into the chunk.
Default position is 0 (start of chunk). Default position is 0 (start of chunk).
If the file is not seekable, this will result in an error. If the file is not seekable, this will result in an error.
@ -94,9 +94,9 @@ class Chunk:
raise ValueError, "I/O operation on closed file" raise ValueError, "I/O operation on closed file"
if not self.seekable: if not self.seekable:
raise IOError, "cannot seek" raise IOError, "cannot seek"
if mode == 1: if whence == 1:
pos = pos + self.size_read pos = pos + self.size_read
elif mode == 2: elif whence == 2:
pos = pos + self.chunk_size pos = pos + self.chunk_size
if pos < 0 or pos > self.chunksize: if pos < 0 or pos > self.chunksize:
raise RuntimeError raise RuntimeError
@ -108,9 +108,9 @@ class Chunk:
raise ValueError, "I/O operation on closed file" raise ValueError, "I/O operation on closed file"
return self.size_read return self.size_read
def read(self, n = -1): def read(self, size = -1):
"""Read at most n bytes from the chunk. """Read at most size bytes from the chunk.
If n is omitted or negative, read until the end If size is omitted or negative, read until the end
of the chunk. of the chunk.
""" """
@ -118,11 +118,11 @@ class Chunk:
raise ValueError, "I/O operation on closed file" raise ValueError, "I/O operation on closed file"
if self.size_read >= self.chunksize: if self.size_read >= self.chunksize:
return '' return ''
if n < 0: if size < 0:
n = self.chunksize - self.size_read size = self.chunksize - self.size_read
if n > self.chunksize - self.size_read: if size > self.chunksize - self.size_read:
n = self.chunksize - self.size_read size = self.chunksize - self.size_read
data = self.file.read(n) data = self.file.read(size)
self.size_read = self.size_read + len(data) self.size_read = self.size_read + len(data)
if self.size_read == self.chunksize and \ if self.size_read == self.chunksize and \
self.align and \ self.align and \