ContinueIndependently (Daemon subroutine): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(5 intermediate revisions by one other user not shown)
Line 10: Line 10:
<td>A previously defined <var>Daemon</var> object. </td></tr>
<td>A previously defined <var>Daemon</var> object. </td></tr>


<tr><th>inputObj</th>
<tr><th><var>Input</var></th>
<td>This optional, [[Notation conventions for methods#Named parameters|name allowed]], argument is either:
<td>This optional, [[Notation conventions for methods#Named parameters|name allowed]], argument is an object passed to the <var class="term">daemon</var> thread. This object must be deep copyable, as described in: [[Copying objects|"Copying objects"]].
<ul>
</td></tr></table>
<li>An object passed to the <var class="term">daemon</var> thread. This object must be deep copyable, as described in: [[Copying objects|"Copying objects"]].   
 
<li>A Boolean value. If a Null object
==Exceptions==
</ul>
<var>ContinueIndependently</var> can throw the following exception:
</table>
   
<dl>
<dt><var>[[DaemonLost_class|DaemonLost]]</var>
<dd>If <var class="term">daemon</var> is lost (probably restarted), a <var>DaemonLost</var> exception is thrown. Since <var>ContinueIndependently</var> does not wait for the <var>daemon</var> thread to do anything, a <var>DaemonLost</var> exception indicates that the daemon thread was lost <b><i>before</i></b> <var>ContinueIndependently</var> was invoked.
</dl>


==Usage notes==
==Usage notes==
Line 22: Line 26:
<li>Issuing <var>ContinueIndependently</var> against a daemon not in a <var>ReturnToMaster</var> wait results in an <var>[[IncorrectDaemonState class|IncorrectDaemonState]]</var> exception.</li>
<li>Issuing <var>ContinueIndependently</var> against a daemon not in a <var>ReturnToMaster</var> wait results in an <var>[[IncorrectDaemonState class|IncorrectDaemonState]]</var> exception.</li>
<li>The <var>[[Continue (Daemon function)|Continue]]</var> and <var>[[ContinueAsynchronously (Daemon subroutine)|ContinueAsynchronously]]</var> methods also tell a daemon to continue from a <var>ReturnToMaster</var> wait.</li>
<li>The <var>[[Continue (Daemon function)|Continue]]</var> and <var>[[ContinueAsynchronously (Daemon subroutine)|ContinueAsynchronously]]</var> methods also tell a daemon to continue from a <var>ReturnToMaster</var> wait.</li>
<li>After a <var>ContinueIndependently</var> (or <var>[[RunIndependently (Daemon subroutine)|RunIndependently]]</var>) method, the <var class="term">daemon</var> object is set to null. This is because the <var class="term">daemon</var> thread runs completely independently of the parent thread once a <var>ContinueIndependently</var> method is invoked.
<li>No <var>Daemon</var> class mechanism is provided for a parent thread to retrieve the output from an independently running <var>Daemon</var>.
<li>For more information about independent daemons, see [[Daemon class#Asynchronous and Independent daemons|"Asynchronous and Independent daemons"]].
</ul>
</ul>



Latest revision as of 16:02, 5 August 2014

Continue processing independently in daemon (Daemon class)

[Introduced in Sirius Mods 8.1]


This method tells a daemon that did a ReturnToMaster Daemon class call to continue processing at the point of the call. Unlike the Continue method, ContinueIndependently returns immediately, thus allowing the thread that issued ContinueIndependently to run in parallel with the daemon thread. Unlike ContinueAsynchronously, this method makes the daemon thread completely independent of the parent thread, so the daeamon is no longer available.

Syntax

daemon:ContinueIndependently[( [Input= object])] Throws DaemonLost, IncorrectDaemonState

Syntax terms

daemon A previously defined Daemon object.
Input This optional, name allowed, argument is an object passed to the daemon thread. This object must be deep copyable, as described in: "Copying objects".

Exceptions

ContinueIndependently can throw the following exception:

DaemonLost
If daemon is lost (probably restarted), a DaemonLost exception is thrown. Since ContinueIndependently does not wait for the daemon thread to do anything, a DaemonLost exception indicates that the daemon thread was lost before ContinueIndependently was invoked.

Usage notes

  • Issuing ContinueIndependently against a daemon not in a ReturnToMaster wait results in an IncorrectDaemonState exception.
  • The Continue and ContinueAsynchronously methods also tell a daemon to continue from a ReturnToMaster wait.
  • After a ContinueIndependently (or RunIndependently) method, the daemon object is set to null. This is because the daemon thread runs completely independently of the parent thread once a ContinueIndependently method is invoked.
  • No Daemon class mechanism is provided for a parent thread to retrieve the output from an independently running Daemon.
  • For more information about independent daemons, see "Asynchronous and Independent daemons".

Examples

See also