Eclipse CDT
Pre-release 3.0

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

Eclipse CDT
Pre-release 3.0

Copyright (c) IBM Corp. and others 2004. All Rights Reserved.