Eclipse CDT
7.0

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

All Superinterfaces:
ICDIObject

public interface ICDIMemorySpaceEncoder
extends ICDIObject

Add-on interface for objects that implement ICDIMemorySpaceManagement. Provides the string encoding and decoding of a memory space qualified address. CDT provides a default encoding of [memory-space-id]:[expression]. If this is adequate, the CDI client need not implement this interface. This method is called when having to represent a memory-space qualified address as a single string.

Since:
7.0

Nested Class Summary
static interface ICDIMemorySpaceEncoder.DecodeResult
           
 
Method Summary
 ICDIMemorySpaceEncoder.DecodeResult decodeAddress(java.lang.String str)
          The inverse of encodeAddress(String, String).
 java.lang.String encodeAddress(java.lang.String expression, java.lang.String memorySpaceID)
          Encode an expression + memory space ID to a string.
 
Methods inherited from interface org.eclipse.cdt.debug.core.cdi.model.ICDIObject
getTarget
 

Method Detail

encodeAddress

java.lang.String encodeAddress(java.lang.String expression,
                               java.lang.String memorySpaceID)
Encode an expression + memory space ID to a string.

Parameters:
expression - the expression representing a location within a memory space. This can be a simple numeric expression like "0x10000" or something more complex "$EAX+(gCustomerCount*100)".
memorySpaceID - a string which represents the memory space
Returns:
the encoded string representation of the address; never null

decodeAddress

ICDIMemorySpaceEncoder.DecodeResult decodeAddress(java.lang.String str)
                                                  throws CDIException
The inverse of encodeAddress(String, String).

Parameters:
str - the encoded string
Returns:
the result of decoding the string into its components; never null
Throws:
CDIException - if string is not in the expected format

Eclipse CDT
7.0

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