Method string

qiling/os/memory.py:108–122

Read or write string to memory. Args: addr: source / destination address value: string to write, or None if reading one from memory encoding: string encoding Returns: null-terminated string read from memory, or None if wrote one

(self, addr: int, value=None, encoding='utf-8')

    # TODO: this is an obsolete utility method that should not be used anymore
    # and here for backward compatibility. use QlOsUtils.read_cstring instead
    def string(self, addr: int, value=None, encoding='utf-8') -> Optional[str]:
        """Read or write string to memory.

        Args:
            addr: source / destination address
            value: string to write, or None if reading one from memory
            encoding: string encoding

        Returns: null-terminated string read from memory, or None if wrote one
        """

        if value is None:
            return self.__read_string(addr)

        self.__write_string(addr, value, encoding)

    def add_mapinfo(self, mem_s: int, mem_e: int, mem_p: int, mem_info: str, mmio_ctx: Optional[QlMmioHandler] = None):
        """Add a new memory range to map.