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) Deprecated. CDI clients should implement ICDIMemorySpaceEncoder
String[]	getMemorySpaces() Provides the memory spaces available.
BigInteger	stringToAddress(String str, StringBuffer memorySpaceID_out) Deprecated. CDI clients should implement ICDIMemorySpaceEncoder

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

getTarget

Method Detail

addressToString

String addressToString(BigInteger address,
                       String memorySpaceID)

Deprecated. CDI clients should implement ICDIMemorySpaceEncoder

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

BigInteger stringToAddress(String str,
                           StringBuffer memorySpaceID_out)
                           throws CDIException

Deprecated. CDI clients should implement ICDIMemorySpaceEncoder

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

String[] getMemorySpaces()

Provides the memory spaces available.

Returns:

an array of memory space identifiers