rapply-one-way

Arguments: function-ref &rest arg-refs

This function, along with the others listed at the end of this page, is used to make remote calls within the dynamic scope of a with-remote-port form. This function returns no values.

The first argument is a function reference that may be a string, a symbol, or a remote reference to a string, symbol or function. Remote references are described in Data representation in rpc.htm. The remote reference is resolved to a function in the remote environment, and the function is called with the arguments passed in the call. The value of the expression is the value or values returned by the remote call. These may be local values or remote references.

This function performs its call like apply, but returns immediately without waiting for any return value. (Contrast with rapply-ignore which ignores its return value but does not return immediately.) If the value to be returned is large or network latency is significant, this may be a very effective optimization.

Note that the execution timing of one-way calls may be indeterminate since each is performed in a separate Lisp thread (in the default case). It is quite possible for a second call from A to be executed before a first call from A.

See also rcall, rcall-ignore, rcall-one-way, rapply, and rapply-ignore.

See also rpc.htm for general information on the Remote Procedure Call utility in Allegro CL.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.