Method PreExecLine

source/Debugger.cpp:81–121

PreExecLine: aLine is about to execute; handle current line marker, breakpoints and step into/over/out.

// PreExecLine: aLine is about to execute; handle current line marker, breakpoints and step into/over/out.
int Debugger::PreExecLine(Line *aLine)
{
	// Using this->mCurrLine might perform a little better than the alternative, at the expense of a
	// small amount of complexity in stack_get (which is only called by request of the debugger client):
	//	mStack.mTop->line = aLine;
	mCurrLine = aLine;
	
	// Check for a breakpoint on the current line:
	Breakpoint *bp = aLine->mBreakpoint;
	if (bp && bp->state == BS_Enabled)
	{
		if (bp->temporary)
		{
			aLine->mBreakpoint = NULL;
			delete bp;
		}
		return Break();
	}

	if ((mInternalState == DIS_StepInto
		|| mInternalState == DIS_StepOver && mStack.Depth() <= mContinuationDepth
		|| mInternalState == DIS_StepOut && mStack.Depth() < mContinuationDepth) // Due to short-circuit boolean evaluation, mStack.Depth() is only evaluated once and only if mInternalState is StepOver or StepOut.
		// Although IF/ELSE/LOOP skips its block-begin, standalone/function-body block-begin still gets here; we want to skip it:
		&& aLine->mActionType != ACT_BLOCK_BEGIN && (aLine->mActionType != ACT_BLOCK_END || aLine->mAttribute) // Ignore { and }; except for function-end, since we want to break there after a "return" to inspect variables while they're still in scope.
		&& aLine->mLineNumber) // Some scripts (i.e. LowLevel/code.ahk) use mLineNumber==0 to indicate the Line has been generated and injected by the script.
	{
		return Break();
	}
	
	// Check if a command was sent asynchronously (while the script was running).
	// Such commands may also be detected via the AHK_CHECK_DEBUGGER message,
	// but if the program is checking for messages infrequently or not at all,
	// the check here is needed to ensure the debugger is responsive.
	if (HasPendingCommand())
	{
		// A command was sent asynchronously.
		return ProcessCommands();
	}
	
	return DEBUGGER_E_OK;
}


bool Debugger::HasPendingCommand()