xref: /freebsd/contrib/llvm-project/lldb/bindings/interface/SBWatchpointDocstrings.i (revision 5fb307d29b364982acbde82cbf77db3cae486f8c)
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     With -1 representing an invalid hardware index."
13 ) lldb::SBWatchpoint::GetHardwareIndex;
14 
15 %feature("docstring", "
16     Get the condition expression for the watchpoint."
17 ) lldb::SBWatchpoint::GetCondition;
18 
19 %feature("docstring", "
20     The watchpoint stops only if the condition expression evaluates to true."
21 ) lldb::SBWatchpoint::SetCondition;
22 
23 %feature("docstring", "
24     Returns the type recorded when the watchpoint was created. For variable
25     watchpoints it is the type of the watched variable. For expression
26     watchpoints it is the type of the provided expression."
27 ) lldb::SBWatchpoint::GetType;
28 
29 %feature("docstring", "
30     Returns the kind of value that was watched when the watchpoint was created.
31     Returns one of the following eWatchPointValueKindVariable,
32     eWatchPointValueKindExpression, eWatchPointValueKindInvalid.
33     "
34 ) lldb::SBWatchpoint::GetWatchValueKind;
35 
36 %feature("docstring", "
37     Get the spec for the watchpoint. For variable watchpoints this is the name
38     of the variable. For expression watchpoints it is empty
39     (may change in the future)."
40 ) lldb::SBWatchpoint::GetWatchSpec;
41 
42 %feature("docstring", "
43     Returns true if the watchpoint is watching reads. Returns false otherwise."
44 ) lldb::SBWatchpoint::IsWatchingReads;
45 
46 %feature("docstring", "
47     Returns true if the watchpoint is watching writes. Returns false otherwise."
48 ) lldb::SBWatchpoint::IsWatchingWrites;
49