org.eclipse.cdt.debug.core.cdi.model
Interface ICDIMemorySpaceManagement

All Superinterfaces:

ICDIObject

public interface ICDIMemorySpaceManagement

extends ICDIObject

The memory space manager provides varous memory-space related operations. The backend implementation of ICDITarget should implement this interface as well if the target supports memory spaces.

Method Summary

String	addressToString(BigInteger address, String memorySpaceID) Optionally provides the string encoding of a memory space qualified address.
String[]	getMemorySpaces() Provides the memory spaces available.
BigInteger	stringToAddress(String str, StringBuffer memorySpaceID_out) The inverse of addressToString.

Methods inherited from interface org.eclipse.cdt.debug.core.cdi.model.ICDIObject

getTarget

Method Detail

addressToString

public String addressToString(BigInteger address,
                              String memorySpaceID)

Optionally provides the string encoding of a memory space qualified address. CDT provides a default encoding of :. If this is adequate, the client can return null from this function.

Parameters:

address - - a numeric address

memorySpaceID - - a string which represents the memory space

Returns:

the encoded string representation of the address or null

stringToAddress

public BigInteger stringToAddress(String str,
                                  StringBuffer memorySpaceID_out)
                           throws CDIException

The inverse of addressToString. Optionally decodes a memoryspace/address string to its components. Client must provide decoding if it provides encoding in addressToString. Conversely, it should return null if addressToString returns null.

Parameters:

str - - the encoded string (contains memory space + hex address value)

memorySpaceID_out - the memory space ID

Returns:

the BigInteger part of str; client should return null if the default decoding provided by CDT is sufficient (:)

Throws:

CDIException - if string is not in the expected format

getMemorySpaces

public String[] getMemorySpaces()

Provides the memory spaces available.

Returns:

an array of memory space identifiers