Eclipse CDT
7.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
 java.lang.String addressToString(java.math.BigInteger address, java.lang.String memorySpaceID)
          Deprecated. CDI clients should implement ICDIMemorySpaceEncoder
 java.lang.String[] getMemorySpaces()
          Provides the memory spaces available.
 java.math.BigInteger stringToAddress(java.lang.String str, java.lang.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

@Deprecated
java.lang.String addressToString(java.math.BigInteger address,
                                            java.lang.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

@Deprecated
java.math.BigInteger stringToAddress(java.lang.String str,
                                                java.lang.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

java.lang.String[] getMemorySpaces()
Provides the memory spaces available.

Returns:
an array of memory space identifiers

Eclipse CDT
7.0

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