|Command||cfunc.debug C Function/C Functions
Applicable release versions: AP 6.1
|Category||C Functions (120)|
|Description||equivalent to the FlashBASIC statement: debug
The C function differs slightly however. The expression passed to _CP_debug will display as a pseudo line number within the FlashBASIC debugger. Variables within the C program are not known to the Flash debugger. For access to these, the user should use a system debugger such as "dbx" or "sdb". The _CP_debug statement is useful however, as it may be used to set breakpoints in Flash subroutines that will be called later.
This function returns -1 if an error occurs. The error code is contained in _CP_errno.
|Syntax||int _CP_debug(int expression)|
/* The following example enters the FlashBASIC debugger and then calls routine "mysub". */ CPSTR * s = _CP_mkstr("mysub"); int i = -1; _CP_debug(1); _CP_call(&i,s,0); When run, the user may enter break points for the not-yet-executed subroutine "mysub". For example, to stop when "mysub" reaches line number 3, the user should type "mysub:b$=3" followed by a "g" at the debugger prompts. The Flash debugger will then break within "mysub" at line number 3.