MemoryDebuggerAPI

#include <VAmiga.h>

class MemoryDebuggerAPI

Defined in VAmiga.h:877

API of the memory debugger (dumps and searches).

Public Methods

Return	Name	Description
MemSrc	getMemSrc const	Returns the memory source for a given address.
const char *	regName const	Returns the name of the custom chip register an address selects.
u8	spypeek8 const	Reads a value from memory without causing side effects.
u16	spypeek16 const	Reads a 16 bit value from memory without causing side effects (see spypeek8()).
string	ascDump const	Returns a string of characters for a portion of memory.
string	hexDump const	Returns a string of numbers for a portion of memory.
string	memDump const	Returns a memory dump that includes a text column (see hexDump()).

---

getMemSrc

const

MemSrc getMemSrc(Accessor src, u32 addr) const

Defined in VAmiga.h:891

Returns the memory source for a given address.

Exceptions

Exception	Description
CoreError	(CoreError::OPT_INV_ARG) if the accessor is invalid.

---

regName

const

const char * regName(u32 addr) const

Defined in VAmiga.h:898

Returns the name of the custom chip register an address selects.

The address is decoded whether or not it names a register, so this is only meaningful for an address getMemSrc() reports as CUSTOM.

---

spypeek8

const

u8 spypeek8(Accessor src, u32 addr) const

Defined in VAmiga.h:903

Reads a value from memory without causing side effects.

Exceptions

Exception	Description
CoreError	(CoreError::OPT_INV_ARG) if the accessor is invalid.

---

spypeek16

const

u16 spypeek16(Accessor src, u32 addr) const

Defined in VAmiga.h:905

Reads a 16 bit value from memory without causing side effects (see spypeek8()).

---

ascDump

const

string ascDump(Accessor src, u32 addr, isize bytes) const

Defined in VAmiga.h:914

Returns a string of characters for a portion of memory.

Parameters

Parameter	Type	Description
src	Accessor	The accessor used to read the bytes.
addr	u32	First address to dump.
bytes	isize	Number of bytes to dump.

Exceptions

Exception	Description
CoreError	(CoreError::OPT_INV_ARG) if the accessor is invalid.

---

hexDump

const

string hexDump(Accessor src, u32 addr, isize bytes, isize sz = 1) const

Defined in VAmiga.h:928

Returns a string of numbers for a portion of memory.

hexDump() shows the bytes as hexadecimal numbers, memDump() as hexadecimal numbers followed by characters. Each group of 'sz' bytes forms one number and is followed by a space.

Parameters

Parameter	Type	Description
src	Accessor	The accessor used to read the bytes.
addr	u32	First address to dump.
bytes	isize	Number of bytes to dump.
sz	isize	Group size in bytes (1, 2, or 4).

Exceptions

Exception	Description
CoreError	(CoreError::OPT_INV_ARG) if the accessor is invalid.

---

memDump

const

string memDump(Accessor src, u32 addr, isize bytes, isize sz = 1) const

Defined in VAmiga.h:930

Returns a memory dump that includes a text column (see hexDump()).