Difference between revisions of "ON FINISH"

From Recital Documentation Wiki
Jump to: navigation, search
Line 22: Line 22:
 
<code lang="recital">
 
<code lang="recital">
 
procedure on_finish
 
procedure on_finish
if getsig() != 0
+
  if getsig() != 0
    dialog box "Signal received. signo = "+alltrim(str(getsig())) label "ON FINISH"
+
      dialog box "Signal received. signo = "+alltrim(str(getsig())) label "ON FINISH"
elseif error() > 0
+
  elseif error() > 0
    dialog box "Error received, error = "+alltrim(str(error())) label "ON FINISH"
+
      dialog box "Error received, error = "+alltrim(str(error())) label "ON FINISH"
else
+
  else
    dialog box "Successful exit" label "ON FINISH"
+
      dialog box "Successful exit" label "ON FINISH"
endif
+
  endif
 
return
 
return
  

Revision as of 16:15, 1 June 2009

Class

Error Handling and Debugging


Purpose

Execute a command when the Recital process ends


Syntax

ON FINISH <command>


See Also

ERROR(), GETSIG(), ON TERMINATION


Description

The ON FINISH command causes the specified <command> to be executed when the Recital process has finished executing. This can be used in conjunction with the GETSIG() and ERROR() functions to determine if the user exited by themselves or if they received a signal to terminate.


Example

procedure on_finish
  if getsig() != 0
      dialog box "Signal received. signo = "+alltrim(str(getsig())) label "ON FINISH"
  elseif error() > 0
      dialog box "Error received, error = "+alltrim(str(error())) label "ON FINISH"
  else
      dialog box "Successful exit" label "ON FINISH"
  endif
return
 
on finish do on_finish


Products

Recital Mirage Server, Recital Terminal Developer