Eclipse Plug-in Developer Guide (Galileo) - IMemoryBlock (Eclipse Platform API Specification)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Eclipse Platform
Release 3.5

PREV CLASS NEXT CLASS

NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.eclipse.debug.core.model
Interface IMemoryBlock

All Superinterfaces:: IAdaptable, IDebugElement

All Known Subinterfaces:: IMemoryBlockExtension

public interface IMemoryBlock
extends IDebugElement
extends IDebugElement

A contiguous segment of memory in an execution context. A memory block is represented by a starting memory address and a length. Not all debug architectures support the retrieval of memory blocks.

Clients may implement this interface.

Since:: 2.0
See Also:: IMemoryBlockRetrieval

Method Summary

byte[] getBytes ()
          Returns the values of the bytes currently contained in this this memory block.

long getLength ()
          Returns the length of this memory block in bytes.

long getStartAddress ()
          Returns the start address of this memory block.

void setValue (long offset, byte[] bytes)
          Sets the value of the bytes in this memory block at the specified offset within this memory block to the specified bytes.

boolean supportsValueModification ()
          Returns whether this memory block supports value modification

Methods inherited from interface org.eclipse.debug.core.model. IDebugElement

getDebugTarget, getLaunch, getModelIdentifier

Methods inherited from interface org.eclipse.core.runtime. IAdaptable

getAdapter

Method Detail

getStartAddress

long getStartAddress()

Returns the start address of this memory block.

Returns:: the start address of this memory block

getLength

long getLength()

Returns the length of this memory block in bytes.

Returns:: the length of this memory block in bytes

getBytes

byte[] getBytes()
                throws 
DebugException

Returns the values of the bytes currently contained in this this memory block.

Returns:

the values of the bytes currently contained in this this memory block

Throws:



DebugException

- if this method fails. Reasons include:

Failure communicating with the debug target. The DebugException's status code contains the underlying exception responsible for the failure.

supportsValueModification

boolean supportsValueModification()

Returns whether this memory block supports value modification

Returns:: whether this memory block supports value modification

setValue

void setValue(long offset,
              byte[] bytes)
              throws 
DebugException

Sets the value of the bytes in this memory block at the specified offset within this memory block to the specified bytes. The offset is zero based.

Parameters:

offset - the offset at which to set the new values

bytes - the new values