Logtalk reference manual
Built-in predicate: threaded_once/1-2
Contents > Reference Manual > Built-in Predicates > threaded_once/1-2

## threaded_once/1-2

#### Description

    threaded_once(Goal)
    threaded_once(Goal, Tag)

Proves `Goal` 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 (this).

The variant `threaded_once/2` returns a threaded call identifier tag that can be used with the `threaded_exit/2` predicate. Tags shall be regarded as an opaque term; users shall not rely on its type.

#### Template and modes

    threaded_once(@callable)
    threaded_once(@callable, -nonvar)

#### Errors

Goal is a variable:
  `instantiation_error`
Goal is neither a variable nor a callable term:
  `type_error(callable, Goal)`
Tag is not a variable:
  `type_error(variable, Goal)`

#### Examples

Prove `Goal` asynchronously in a new thread:
  `threaded_once(Goal)`
Prove `::Message` asynchronously in a new thread:
  `threaded_once(::Message)`
Prove `Object::Message` asynchronously in a new thread:
  `threaded_once(Object::Message)`

#### See also

`threaded_call/1-2`, `threaded_exit/1-2`, `threaded_ignore/1`, `threaded_peek/1-2`
`threaded/1`