GetInputObject (Daemon subroutine): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (match syntax table to syntax template, tags and edits)
Line 1: Line 1:
{{Template:Daemon:GetInputObject subtitle}}
{{Template:Daemon:GetInputObject subtitle}}
 
<var>GetInputObject</var> retrieves the input object passed by the master thread (in the second argument of the <var>[[Run (Daemon function)|Run]]</var> method) making it available to the daemon.
GetInputObject is a member of the [[Daemon class]]
 
This shared method retrieves the input object passed by the master thread (in the second argument of the Run method) and makes it available to the daemon.


==Syntax==
==Syntax==
Line 11: Line 8:
<tr><th>%(Daemon)</th>
<tr><th>%(Daemon)</th>
<td>The class name in parentheses denotes a shared method. <var>GetInputObject</var> can also be invoked via a <var>Daemon</var> object variable, which may be null.</td></tr>
<td>The class name in parentheses denotes a shared method. <var>GetInputObject</var> can also be invoked via a <var>Daemon</var> object variable, which may be null.</td></tr>
<tr><th>%inputObj</th>
<tr><th>object</th>
<td>The object passed to the daemon method object in the last Run method invocation. '''%inputObj''' must be deep copyable, as described in [[Copying objects]].</td></tr>
<td>The object passed to the daemon method object in the most recent Daemon <var>[[Run (Daemon function)|Run]]</var> invocation. <var class="term">object</var> must be deep copyable, as described in [[Copying objects|"Copying objects"]].</td></tr>
</table>
</table>


==Usage notes==
==Usage notes==
<ul>
<ul>  
<li><var>GetInputObject</var> may not be issued on a master thread.  
<li>GetInputObject may not be issued on a master thread.  
<li>If the input object passed by Daemon <var>[[Run (Daemon function)|Run]]</var> does not match the <var class="term">object</var> argument of <var>GetInputObject</var>, the request containing <var>GetInputObject</var> is cancelled.  
<li>If the input object passed by the Run method does not match the '''%inputObj''' argument of GetInputObject, the request containing GetInputObject is cancelled.  
<li><var>GetInputObject</var> sets its argument to null if no object or a null object is passed by <var>[[Run (Daemon function)|Run]]</var>, and any subsequent references to that object cancel the request.
<li>GetInputObject sets its argument to null if no object or a null object is passed by Run, and subsequent references to that object cancel the request.
</ul>
</ul>


==See also==
==See also==
{{Template:Daemon:GetInputObject footer}}
{{Template:Daemon:GetInputObject footer}}

Revision as of 01:06, 14 March 2011

Retrieve input object passed by master thread (Daemon class)

GetInputObject retrieves the input object passed by the master thread (in the second argument of the Run method) making it available to the daemon.

Syntax

%(Daemon):GetInputObject( object)

Syntax terms

%(Daemon) The class name in parentheses denotes a shared method. GetInputObject can also be invoked via a Daemon object variable, which may be null.
object The object passed to the daemon method object in the most recent Daemon Run invocation. object must be deep copyable, as described in "Copying objects".

Usage notes

  • GetInputObject may not be issued on a master thread.
  • If the input object passed by Daemon Run does not match the object argument of GetInputObject, the request containing GetInputObject is cancelled.
  • GetInputObject sets its argument to null if no object or a null object is passed by Run, and any subsequent references to that object cancel the request.

See also