Method read_ptr

qiling/os/memory.py:361–381

Read an integer value from a memory address. Bytes read will be unpacked using emulated architecture properties. Args: addr: memory address to read size: pointer size (in bytes): either 1, 2, 4, 8, or 0 for arch native size signed: interpret value

(self, addr: int, size: int = 0, *, signed = False)

        return self.ql.uc.mem_read(addr, size)

    def read_ptr(self, addr: int, size: int = 0, *, signed = False) -> int:
        """Read an integer value from a memory address.
        Bytes read will be unpacked using emulated architecture properties.

        Args:
            addr: memory address to read
            size: pointer size (in bytes): either 1, 2, 4, 8, or 0 for arch native size
            signed: interpret value as a signed integer (default: False)

        Returns: integer value stored at the specified memory address
        """

        if not size:
            size = self.ql.arch.pointersize

        try:
            _unpack = self._unpackers[(size, signed)]
        except KeyError:
            raise QlErrorStructConversion(f"Unsupported pointer size: {size}")

        return _unpack(self.read(addr, size))

    def write(self, addr: int, data: bytes) -> None:
        """Write bytes to a memory.