76 lines
3.0 KiB
HTML
76 lines
3.0 KiB
HTML
|
<?xml version="1.0" encoding="utf-8"?>
|
||
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
|
||
|
|
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
||
|
|
|
||
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
||
|
|
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="content-type" content="application/xml+xhtml; charset=utf-8" />
|
||
|
|
<title>Logtalk built-in predicate: threaded_once/1-2</title>
|
||
|
|
<link rel="stylesheet" href="../../screen.css" type="text/css" media="screen"/>
|
||
|
|
<link rel="stylesheet" href="../../print.css" type="text/css" media="print"/>
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<body>
|
||
|
|
|
||
|
|
<div class="top-left">Logtalk reference manual</div>
|
||
|
|
<div class="top-right">Built-in predicate: threaded_once/1-2</div>
|
||
|
|
<div class="bottom-left"><span class="page"/></div>
|
||
|
|
<div class="bottom-right"><span class="page"/></div>
|
||
|
|
<div class="navtop"><a href="../../index.html">contents</a> > <a href="../index.html">reference manual</a> > <a href="../index.html#builtins">built-in predicates</a></div>
|
||
|
|
|
||
|
|
<h2 id="builtins_threaded_once1_2" class="codenp">threaded_once/1-2</h2>
|
||
|
|
|
||
|
|
<h4>Description</h4>
|
||
|
|
|
||
|
|
<pre>threaded_once(Goal)
|
||
|
|
threaded_once(Goal, Tag)</pre>
|
||
|
|
<p>
|
||
|
|
Proves <code>Goal</code> asynchronously using a new thread. Only the first goal solution is found. The argument can be a message sending goal. This call always succeeds. The result (success, failure, or exception) is sent back to the message queue of the object containing the call (<em>this</em>).
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
The variant <code>threaded_once/2</code> returns a threaded call identifier tag that can be used with the <a title="Consult reference manual" href="threaded_exit1_2.html"><code>threaded_exit/2</code></a> predicate. Tags shall be considered as an opaque term; users shall not rely on its type.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h4>Template and modes</h4>
|
||
|
|
|
||
|
|
<pre>threaded_once(@callable)
|
||
|
|
threaded_once(@callable, -nonvar)</pre>
|
||
|
|
|
||
|
|
<h4>Errors</h4>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt>Goal is a variable:</dt>
|
||
|
|
<dd><code>instantiation_error</code></dd>
|
||
|
|
<dt>Goal is neither a variable nor a callable term:</dt>
|
||
|
|
<dd><code>type_error(callable, Goal)</code></dd>
|
||
|
|
<dt>Tag is not a variable:</dt>
|
||
|
|
<dd><code>type_error(variable, Goal)</code></dd>
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<h4>Examples</h4>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt>Prove <code>Goal</code> asynchronously in a new thread:</dt>
|
||
|
|
<dd><code>threaded_once(Goal)</code></dd>
|
||
|
|
<dt>Prove <code>::Message</code> asynchronously in a new thread:</dt>
|
||
|
|
<dd><code>threaded_once(::Message)</code></dd>
|
||
|
|
<dt>Prove <code>Object::Message</code> asynchronously in a new thread:</dt>
|
||
|
|
<dd><code>threaded_once(Object::Message)</code></dd>
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<div class="footer">
|
||
|
|
<div class="copyright">
|
||
|
|
<span>Copyright © <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> — <a href="http://logtalk.org">Logtalk.org</a></span><br/>
|
||
|
|
<span>Last updated on: September 15, 2007</span>
|
||
|
|
</div>
|
||
|
|
<div class="navbottom">
|
||
|
|
<span><a href="threaded_call1_2.html">previous</a> | <a href="../../glossary.html">glossary</a> | <a href="threaded_ignore1.html">next</a></span><br/>
|
||
|
|
<span><a href="http://validator.w3.org/check/referer">XHTML</a> + <a href="http://jigsaw.w3.org/css-validator/check/referer">CSS</a></span>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
|
||
|
|
</html>
|