xref: /freebsd/contrib/llvm-project/lldb/bindings/interface/SBWatchpointDocstrings.i (revision 95eb4b873b6a8b527c5bd78d7191975dfca38998)
1 %feature("docstring",
2 "Represents an instance of watchpoint for a specific target program.
3 
4 A watchpoint is determined by the address and the byte size that resulted in
5 this particular instantiation.  Each watchpoint has its settable options.
6 
7 See also :py:class:`SBTarget.watchpoint_iter()` for example usage of iterating through the
8 watchpoints of the target."
9 ) lldb::SBWatchpoint;
10 
11 %feature("docstring", "
12     Deprecated.  Previously: Return the hardware index of the
13     watchpoint register.  Now: -1 is always returned."
14 ) lldb::SBWatchpoint::GetHardwareIndex;
15 
16 %feature("docstring", "
17     Get the condition expression for the watchpoint."
18 ) lldb::SBWatchpoint::GetCondition;
19 
20 %feature("docstring", "
21     The watchpoint stops only if the condition expression evaluates to true."
22 ) lldb::SBWatchpoint::SetCondition;
23 
24 %feature("docstring", "
25     Returns the type recorded when the watchpoint was created. For variable
26     watchpoints it is the type of the watched variable. For expression
27     watchpoints it is the type of the provided expression."
28 ) lldb::SBWatchpoint::GetType;
29 
30 %feature("docstring", "
31     Returns the kind of value that was watched when the watchpoint was created.
32     Returns one of the following eWatchPointValueKindVariable,
33     eWatchPointValueKindExpression, eWatchPointValueKindInvalid.
34     "
35 ) lldb::SBWatchpoint::GetWatchValueKind;
36 
37 %feature("docstring", "
38     Get the spec for the watchpoint. For variable watchpoints this is the name
39     of the variable. For expression watchpoints it is empty
40     (may change in the future)."
41 ) lldb::SBWatchpoint::GetWatchSpec;
42 
43 %feature("docstring", "
44     Returns true if the watchpoint is watching reads. Returns false otherwise."
45 ) lldb::SBWatchpoint::IsWatchingReads;
46 
47 %feature("docstring", "
48     Returns true if the watchpoint is watching writes. Returns false otherwise."
49 ) lldb::SBWatchpoint::IsWatchingWrites;
50