Top | ![]() |
![]() |
![]() |
![]() |
guint64 | address | Read / Write |
gint64 | count | Read / Write |
IdeDebuggerDisposition | disposition | Read / Write |
gboolean | enabled | Read / Write |
gchar * | file | Read / Write |
gchar * | function | Read / Write |
gchar * | id | Read / Write / Construct Only |
guint | line | Read / Write |
IdeDebuggerBreakMode | mode | Read / Write |
gchar * | spec | Read / Write |
gchar * | thread | Read / Write |
gint ide_debugger_breakpoint_compare (IdeDebuggerBreakpoint *a
,IdeDebuggerBreakpoint *b
);
IdeDebuggerBreakpoint *
ide_debugger_breakpoint_new (const gchar *id
);
const gchar *
ide_debugger_breakpoint_get_id (IdeDebuggerBreakpoint *self
);
Gets the identifier for the breakpoint that is backend specific.
Since: 3.26
gboolean
ide_debugger_breakpoint_get_enabled (IdeDebuggerBreakpoint *self
);
Checks if the breakpoint is enabled.
void ide_debugger_breakpoint_set_enabled (IdeDebuggerBreakpoint *self
,gboolean enabled
);
Sets the enabled state of the breakpoint instance.
You must call ide_debugger_breakpoint_modify_breakpoint_async()
to actually
modify the breakpoint in the backend.
Since: 3.26
IdeDebuggerBreakMode
ide_debugger_breakpoint_get_mode (IdeDebuggerBreakpoint *self
);
Gets teh mode for the breakpoint. This describes if the breakpoint is a normal breakpoint type, countpoint, or watchpoint.
See also: IdeDebuggerBreakMode
Since: 3.26
void ide_debugger_breakpoint_set_mode (IdeDebuggerBreakpoint *self
,IdeDebuggerBreakMode mode
);
Sets the "mode" property for the breakpoint.
This should represent the mode for which the breakpoint is used.
For example, if it is a countpoint (a breakpoint which increments a
counter), you would use IDE_DEBUGGER_BREAK_COUNTPOINT
.
Since: 3.26
IdeDebuggerDisposition
ide_debugger_breakpoint_get_disposition
(IdeDebuggerBreakpoint *self
);
Gets the "disposition" property of the breakpoint.
Since: 3.26
void ide_debugger_breakpoint_set_disposition (IdeDebuggerBreakpoint *self
,IdeDebuggerDisposition disposition
);
Sets the "disposition" property.
The disposition property is used to to track what should happen to a breakpoint when movements are made in the debugger.
Since: 3.26
IdeDebuggerAddress
ide_debugger_breakpoint_get_address (IdeDebuggerBreakpoint *self
);
Gets the "address" property, which defines where the breakpoint is located in memory.
Builder only supports up to 64-bit addresses at this time.
Since: 3.26
void ide_debugger_breakpoint_set_address (IdeDebuggerBreakpoint *self
,IdeDebuggerAddress address
);
Sets the address of the breakpoint, if any.
Since: 3.26
const gchar *
ide_debugger_breakpoint_get_spec (IdeDebuggerBreakpoint *self
);
Gets the "spec" property of the breakpoint.
The spec is used when the IdeDebuggerBreakMode is
IDE_DEBUGGER_BREAK_WATCHPOINT
.
void ide_debugger_breakpoint_set_spec (IdeDebuggerBreakpoint *self
,const gchar *spec
);
Sets the specification for the debugger breakpoint. This describes a statement which the debugger can use to determine of the breakpoint should be applied when stopping the debugger.
Since: 3.26
const gchar *
ide_debugger_breakpoint_get_function (IdeDebuggerBreakpoint *self
);
Gets the "function" property of the breakpoint.
This is a user-readable value representing the name of the function.
Since: 3.26
void ide_debugger_breakpoint_set_function (IdeDebuggerBreakpoint *self
,const gchar *function
);
Sets the "function" property, which is a user-readable value representing the name of the function.
Since: 3.26
const gchar *
ide_debugger_breakpoint_get_file (IdeDebuggerBreakpoint *self
);
Gets the file that contains the breakpoint. This may be NULL
, particularly
if the breakpoint does not exist with in a known file, such as at a memory
address.
Since: 3.26
void ide_debugger_breakpoint_set_file (IdeDebuggerBreakpoint *self
,const gchar *file
);
Sets the file that contains the breakpoint, if any.
Since: 3.26
guint
ide_debugger_breakpoint_get_line (IdeDebuggerBreakpoint *self
);
Gets the "line" property, which is the line number within the file that contains the breakpoint.
This value is indexed from 1, and 0 indicates that the value is unset.
Since: 3.26
void ide_debugger_breakpoint_set_line (IdeDebuggerBreakpoint *self
,guint line
);
Sets the line for the breakpoint. A value of 0 means the line is unset.
Since: 3.26
gint64
ide_debugger_breakpoint_get_count (IdeDebuggerBreakpoint *self
);
Gets the number of times the breakpoint has been reached, if supported by the debugger backend.
An integer greater than or equal to zero representing the number of times the breakpoint has been reached.
Since: 3.26
void ide_debugger_breakpoint_set_count (IdeDebuggerBreakpoint *self
,gint64 count
);
Sets the number of times the breakpoint has been reached if the breakpoint is a countpoint (or if the backend supports counting of regular breakpoints).
Since: 3.26
const gchar *
ide_debugger_breakpoint_get_thread (IdeDebuggerBreakpoint *self
);
Gets the "thread" property, which is the thread the breakpoint is currently stopped in (if any).
Since: 3.26
void ide_debugger_breakpoint_set_thread (IdeDebuggerBreakpoint *self
,const gchar *thread
);
Sets the thread that the breakpoint is currently stopped in.
This should generally only be used by debugger implementations.
Since: 3.26
#define IDE_TYPE_DEBUGGER_BREAKPOINT (ide_debugger_breakpoint_get_type())
struct IdeDebuggerBreakpointClass { GObjectClass parent_class; void (*reset) (IdeDebuggerBreakpoint *self); };
“address”
property “address” guint64
The address of the breakpoint, if available.
Builder only supports up to 64-bit addresses at this time.
Flags: Read / Write
Default value: 0
Since: 3.26
“count”
property “count” gint64
The number of times the breakpoint has been reached.
This is backend specific, and may not be supported by all backends.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
Since: 3.26
“disposition”
property“disposition” IdeDebuggerDisposition
This property describes what should happen to the breakpoint upon the next stop of the debugger.
Generally, breakpoints are kept. But some backends allow you to remove a breakpoint upon the next stop of the debugger or when the breakpoint is next reached.
This is backend specific, and not all values may be supported by all backends.
Flags: Read / Write
Default value: IDE_DEBUGGER_DISPOSITION_KEEP
Since: 3.26
“enabled”
property “enabled” gboolean
This property is TRUE
when the breakpoint is enabled.
Flags: Read / Write
Default value: TRUE
Since: 3.26
“file”
property “file” gchar *
The file containing the breakpoint, if any.
If the breakpoint exists at an assembly instruction that cannot be
represented by a file, this will be NULL
.
Flags: Read / Write
Default value: NULL
Since: 3.26
“function”
property “function” gchar *
The name of the function containing the breakpoint.
The value of this is backend specific and may look vastly different based on the language being debugged.
Flags: Read / Write
Default value: NULL
Since: 3.26
“id”
property “id” gchar *
The identifier of the breakpoint.
This is backend specific.
Flags: Read / Write / Construct Only
Default value: NULL
Since: 3.26
“line”
property “line” guint
The line number within “file” where the breakpoint exists.
Flags: Read / Write
Default value: 0
Since: 3.26
“mode”
property“mode” IdeDebuggerBreakMode
The mode of the breakpoint, such as a breakpoint, countpoint, or watchpoint.
Flags: Read / Write
Default value: IDE_DEBUGGER_BREAK_BREAKPOINT
Since: 3.26
“spec”
property “spec” gchar *
The specification for the breakpoint, which may be used by watchpoints to determine of the breakpoint should be applied while executing.
Flags: Read / Write
Default value: NULL
Since: 3.26
“reset”
signalvoid user_function (IdeDebuggerBreakpoint *self, gpointer user_data)
The "reset" signal is emitted after the debugger has exited so that the breakpoint can reset any internal state. This allows the breakpoint to be propagated to the next debugger instance, allowing the user to move between debugger sessions without loosing state.
Flags: Run Last
Since: 3.26