scsh-conservatory
/
scsh-expect
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

- completed chat documentation

This commit is contained in:
frese 2004-09-20 01:36:10 +00:00
parent 10bc934a43
commit a5b218c7e6
1 changed files with 21 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
doc/chat.doc
View File

@ -1,16 +1,29 @@
(chat <task> <body> ...) -------------------------------------------------------------------------------
(CHAT <task> <body> ...) -> values syntax
dynvars: $task $chat-cont $chat-abort-re $chat-timeout Chat introduces a programmed conversation with a given task. Within
the body expressions, the LOOK-FOR and SEND functions are intended to
either wait for an output of the task, or to send a message to the
task respectively. Furthermore, there are some side-effecting
functions that set some options for this chat.
(look-for* re [on-timeout]) (look-for* re [on-timeout])
(look-for re [on-timeout ...]) (look-for re [<body> ...])
LOOK-FOR waits until a portion of the task's output matches the given
regular expression. The optional second argument of LOOK-FOR*, or the
body expressions in the LOOK-FOR macro, are executed if the output of
the task does not match within the time specified by the CHAT-TIMEOUT
option (see below).
(send fmt arg ...) (send fmt arg ...)
(send/cr fmt arg ...) (send/cr fmt arg ...)
logging output funs? SEND simply writes a formatted string to the input-port of the task
(see FORMAT). SEND/CR adds a carriage-return character to the end of
the string.
side-effecting option setting Side-effecting option setting functions:
(chat-abort <re>) (chat-abort <re>)
if this regular expression is matched, the chat call is aborted. if this regular expression is matched, the chat call is aborted.
(chat-timeout <nsecs>) (chat-timeout <nsecs>)
@ -18,17 +31,17 @@ side-effecting option setting
(chat-monitor <monitor>) (chat-monitor <monitor>)
monitor has to be a function taking two arguments (event val), monitor has to be a function taking two arguments (event val),
where event is a symbol, and val a possible value for this where event is a symbol, and val a possible value for this
event: event. The events and the possible type of value are:
- looking-for(re) - looking-for(re)
- found(match) - found(match)
- new-input(text) - new-input(text)
- sending(text) - sending(text)
- abort(text) - abort(match)
- eof - eof
- timeout - timeout
chat can return the following values: chat can return the following values:
- 'eof - 'eof
- 'timeout if no timeout-handler was specified in a look-for clause - 'timeout if no timeout-handler was specified in a look-for clause
- <string> in case of an abortion the submatch of the abort-regexp - <match> in case of an abortion the match of the abort-regexp
- #f if the whole body evaluated normally - #f if the whole body evaluated normally