blob: dc8d0f5b2d44fb2a64b4900998f8e6f079ba96c4 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
package org.eclipse.debug.core.model;
import org.eclipse.debug.core.DebugException;
/**
* Provides the ability to modify the value of a variable in
* the target.
* <p>
* Clients may implement this interface.
* </p>
* <p>
* <b>Note:</b> This class/interface is part of an interim API that is still under development and expected to
* change significantly before reaching stability. It is being made available at this early stage to solicit feedback
* from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
* (repeatedly) as the API evolves.
* </p>
* @see IVariable
*/
public interface IValueModification {
/**
* Attempts to set the value of this variable to the
* value of the given expression.
*
* @param expression an expression to generate a new value
* @exception DebugException on failure. Reasons include:<ul>
* <li>TARGET_REQUEST_FAILED - The request failed in the target
* <li>NOT_SUPPORTED - The capability is not supported by the target
* </ul>
*/
public void setValue(String expression) throws DebugException;
/**
* Returns whether this varaible supports value modification.
*
* @return whether this varaible supports value modification
*/
public boolean supportsValueModification();
/**
* Returns whether the given expression is valid to be used in
* setting a new value for this variable.
*
* @param expression an expression to generate a new value
* @return whether the expression is acceptable
* @exception DebugException on failure. Reasons include:<ul>
* <li>TARGET_REQUEST_FAILED - The request failed in the target
* <li>NOT_SUPPORTED - The capability is not supported by the target
* </ul>
*/
public boolean verifyValue(String expression) throws DebugException;
}
|