Method getinto

dwave/cloud/upload.py:178–206

Copy a slice of file's content into a pre-allocated bytes-like object buf. For example, buf might be a `bytearray`. Args: key (slice/int): Source data address coded as a `slice` object or int position. buf (bytes-like): Target

(self, key, buf)

        return self._size

    def getinto(self, key, buf):
        """Copy a slice of file's content into a pre-allocated bytes-like
        object buf. For example, buf might be a `bytearray`.

        Args:
            key (slice/int):
                Source data address coded as a `slice` object or int position.
            buf (bytes-like):
                Target pre-allocated bytes-like object.

        Returns:
            int:
                The number of bytes read (0 for EOF).
        """

        start, stop, _ = self._getkey_to_range(key)

        # empty slice
        if stop <= start:
            return 0

        # copy source[start:stop] => target[0:stop-start]
        size = stop - start
        target = memoryview(buf)[:size]

        # slice is an atomic "seek and read" operation
        with self._lock:
            self._fp.seek(start)
            return self._fp.readinto(target)


class GettableMemory(GettableBase):