.. versionadded:: 3.1
The ``SEEK_*`` constants.
- .. versionadded:: 3.3
- Some operating systems could support additional values, like
- :data:`os.SEEK_HOLE` or :data:`os.SEEK_DATA`. The valid values
- for a file could depend on it being open in text or binary mode.
-
.. method:: seekable()
Return ``True`` if the stream supports random access. If ``False``,
Parameters to the :func:`lseek` function. Their values are 0, 1, and 2,
respectively. Availability: Windows, Unix.
- .. versionadded:: 3.3
- Some operating systems could support additional values, like
- :data:`os.SEEK_HOLE` or :data:`os.SEEK_DATA`.
-
.. function:: mkdirat(dirfd, path, mode=0o777)
* 0 -- start of stream (the default); offset should be zero or positive
* 1 -- current stream position; offset may be negative
* 2 -- end of stream; offset is usually negative
- Some operating systems / file systems could provide additional values.
Return an int indicating the new absolute position.
"""
elif whence == 2:
self._pos = max(0, len(self._buffer) + pos)
else:
- raise ValueError("unsupported whence value")
+ raise ValueError("invalid whence value")
return self._pos
def tell(self):
return _BufferedIOMixin.tell(self) - len(self._read_buf) + self._read_pos
def seek(self, pos, whence=0):
+ if not (0 <= whence <= 2):
+ raise ValueError("invalid whence value")
with self._read_lock:
if whence == 1:
pos -= len(self._read_buf) - self._read_pos
return _BufferedIOMixin.tell(self) + len(self._write_buf)
def seek(self, pos, whence=0):
+ if not (0 <= whence <= 2):
+ raise ValueError("invalid whence")
with self._write_lock:
self._flush_unlocked()
return _BufferedIOMixin.seek(self, pos, whence)
BufferedWriter.__init__(self, raw, buffer_size, max_buffer_size)
def seek(self, pos, whence=0):
+ if not (0 <= whence <= 2):
+ raise ValueError("invalid whence")
self.flush()
if self._read_buf:
# Undo read ahead.
self._decoder.reset()
return position
if whence != 0:
- raise ValueError("unsupported whence (%r)" % (whence,))
+ raise ValueError("invalid whence (%r, should be 0, 1 or 2)" %
+ (whence,))
if cookie < 0:
raise ValueError("negative seek position %r" % (cookie,))
self.flush()
# Python uses fixed values for the SEEK_ constants; they are mapped
# to native constants if necessary in posixmodule.c
-# Other possible SEEK values are directly imported from posixmodule.c
SEEK_SET = 0
SEEK_CUR = 1
SEEK_END = 2
posix.RTLD_GLOBAL
posix.RTLD_LOCAL
- @unittest.skipUnless('PC_MIN_HOLE_SIZE' in os.pathconf_names,
- "test needs an OS that reports file holes")
- def test_fs_holes(self) :
- # Even if the filesystem doesn't report holes,
- # if the OS supports it the SEEK_* constants
- # will be defined and will have a consistent
- # behaviour:
- # os.SEEK_DATA = current position
- # os.SEEK_HOLE = end of file position
- with open(support.TESTFN, 'r+b') as fp :
- fp.write(b"hello")
- fp.flush()
- size = fp.tell()
- fno = fp.fileno()
- for i in range(size) :
- self.assertEqual(i, os.lseek(fno, i, os.SEEK_DATA))
- self.assertLessEqual(size, os.lseek(fno, i, os.SEEK_HOLE))
- self.assertRaises(OSError, os.lseek, fno, size, os.SEEK_DATA)
- self.assertRaises(OSError, os.lseek, fno, size, os.SEEK_HOLE)
-
class PosixGroupsTester(unittest.TestCase):
def setUp(self):
- Issue #14259: The finditer() method of re objects did not take any
keyword arguments, contrary to the documentation.
-- Issue #10142: Support for SEEK_HOLE/SEEK_DATA (for example, under ZFS).
-
Tests
-----
if (!PyArg_ParseTuple(args, "O|i:seek", &targetobj, &whence)) {
return NULL;
}
-
- /* Do some error checking instead of trusting OS 'seek()'
- ** error detection, just in case.
- */
- if ((whence < 0 || whence >2)
-#ifdef SEEK_HOLE
- && (whence != SEEK_HOLE)
-#endif
-#ifdef SEEK_DATA
- && (whence != SEEK_DATA)
-#endif
- ) {
+ if (whence < 0 || whence > 2) {
PyErr_Format(PyExc_ValueError,
- "whence value %d unsupported", whence);
+ "whence must be between 0 and 2, not %d", whence);
return NULL;
}
if (target == -1 && PyErr_Occurred())
return NULL;
- /* SEEK_SET and SEEK_CUR are special because we could seek inside the
- buffer. Other whence values must be managed without this optimization.
- Some Operating Systems can provide additional values, like
- SEEK_HOLE/SEEK_DATA. */
- if (((whence == 0) || (whence == 1)) && self->readable) {
+ if (whence != 2 && self->readable) {
Py_off_t current, avail;
/* Check if seeking leaves us inside the current buffer,
so as to return quickly if possible. Also, we needn't take the
#endif
-#ifdef SEEK_HOLE
- if (ins(d, "SEEK_HOLE", (long)SEEK_HOLE)) return -1;
-#endif
-#ifdef SEEK_DATA
- if (ins(d, "SEEK_DATA", (long)SEEK_DATA)) return -1;
-#endif
-
/* MS Windows */
#ifdef O_NOINHERIT
/* Don't inherit in child processes. */