Capture (Socket function)
<section begin=dpl_desc/><section end=dpl_desc/>
Capture is a member of the Socket class.
This method
specifies whether print output should be sent as lines on a Janus Sockets connection.
The method, which may be invoked with a CALL statement,
has an effect similar to its equivalent $function,
$Sock_Capture.
Syntax
[%str =] %socko:Capture(value)
Syntax terms
| %str | Optional return string, which contains the value of the socket's previous print capture setting. If the socket is not open, and ONRESET CONTINUE is in effect for the socket, Capture returns the string RESET. For information about ONRESET CONTINUE, see the Set method.
| ||||
|---|---|---|---|---|---|
| %socko | A variable or an expression that is a reference to a Socket object. | ||||
| value | The print capture setting for the socket. It is a string whose valid values are:
|
Usage notes
- Unlike $Sock_Capture, capturing to multiple sockets is not supported with a Socket object.
- Each captured print line is followed by a LINEND string, if the socket has one set in its definition or by the Set method.
- If FIN is sent (using either the Send or SendWithLineEnd method), print capturing is automatically turned OFF for the socket.
For information about "print" output, see "Print capturing hierarchy and other considerations".