83Plus:BCALLs:4027 - Revision history

Dr. D'nar: Explained how to call this from a shell

2013-02-04T18:04:47Z

Explained how to call this from a shell

FloppusMaximus: more info

2008-04-19T05:14:04Z

more info

AndyJ: formatting and punctuation

2008-04-18T16:14:52Z

formatting and punctuation

Luby at 01:33, 15 April 2008

2008-04-15T01:33:03Z

Luby at 20:20, 11 April 2008

2008-04-11T20:20:41Z

New page

[[Category:83Plus:BCALLs:By Name|JForceCmdNoChar]]
[[Category:83Plus:BCALLs:By Name:Utility|JForceCmdNoChar]]
[[Category:83Plus:BCALLs:By Address|4027 - JForceCmdNoChar]]

== Synopsis ==
'''Official Name:''' JForceCmdNoChar
'''BCALL Address:''' 4027

Use "BJUMP", not "BCALL

Exits App and returns to OS.

=== Inputs ===
* None
=== Outputs ===
* None
=== Destroys ===
* All (but it doesn't matter

== Comments ==
This is the proper way to exit an app

== Example ==
<nowiki>
BJUMP JForceCmdNoChar
</nowiki>

@@ Line 19: / Line 19: @@
 == Comments ==
-This routine is the standard way of exiting a Flash Application.  (Although there are other ways, in practice this is the only one you'll ever need.  Note that simply returning with the 'ret' statement does not work.)  In contrast, normal RAM assembly programs should '''never''' use this routine.  (In the middle somewhere are scripts and hooks; don't use this routine in a hook or script unless you really know what you're doing.)
+This routine is the standard way of exiting a Flash Application.  (Although there are other ways, in practice this is the only one you'll ever need.  Note that simply returning with the 'ret' statement does not work.)  In contrast, normal RAM assembly programs should never use this routine, unless you know what you're doing.  (In the middle somewhere are scripts and hooks; don't use this routine in a hook or script unless you really know what you're doing.)
 TI suggests that this routine be called using B_JUMP rather than B_CALL.  In fact it doesn't matter; either way this routine never returns (and of course, using B_CALL saves you two bytes.)  This routine will reset the hardware stack, FPS, and OPS to their default states, so you can call it at any point in the middle of your app.
@@ Line 31: / Line 31: @@
 (Note that PutAway, unlike JForceCmdNoChar, does need to be jumped to -- a B_CALL would not work in this case.)
 == Example ==
   BJUMP JForceCmdNoChar

@@ Line 9: / Line 9: @@
 '''BCALL Address:''' 4027
-Use "BJUMP", not "BCALL".
+Exits the current application and returns to the homescreen.
-−
-Exits App and returns to OS.
 === Inputs ===
@@ Line 21: / Line 19: @@
 == Comments ==
-This is the proper way to exit an app
+This routine is the standard way of exiting a Flash Application.  (Although there are other ways, in practice this is the only one you'll ever need.  Note that simply returning with the 'ret' statement does not work.)  In contrast, normal RAM assembly programs should '''never''' use this routine.  (In the middle somewhere are scripts and hooks; don't use this routine in a hook or script unless you really know what you're doing.)
 == Example ==
   BJUMP JForceCmdNoChar

@@ Line 6: / Line 6: @@
 == Synopsis ==
 '''Official Name:''' JForceCmdNoChar
 '''BCALL Address:''' 4027