Receive string from dialog handling system

DESCRIPTION:

Receives a string from the dialog handling system subprocess. This is generally in response to a command sent to the subprocess via dialog.send. As with dialog.send, it shouldnt be necessary to call this function directly.

Note: This function is deprecated. For more information, see .

USAGE:

dialog.receive() 

VALUE:

Returns a character string. Interpretation of the character string is up to the calling function, which presumably made the dialog.send call that caused the return of this character string.

DETAILS:

A set of functions is provided for manipulating the dialog handling system. Calling dialog.receive directly without going through the standard interface functions can lead to unpredictable results.

This function uses the process class object stored in the session database by dialog.start to designate the process being used. That value along with the arguments to dialog.send are passed off to the psend routine to send a message to the process.

SEE ALSO:

, , , ,

EXAMPLES:

dialog.send('dialog current') 
current <- dialog.receive()