steal_connection


Description:

public IOStream steal_connection ()

"Steals" the HTTP connection associated with this from its Server.

This happens immediately, regardless of the current state of the connection; if the response to this has not yet finished being sent, then it will be discarded; you can steal the connection from a [signal@ServerMessage: SoupServerMessage:wrote-informational] or [signal@ServerMessage:SoupServerMessage:wrote-body] signal handler if you need to wait for part or all of the response to be sent.

Note that when calling this function from C, this will most likely be freed as a side effect.

Parameters:

this

a ServerMessage

Returns:

the IOStream formerly associated with this (or null if this was no longer associated with a connection). No guarantees are made about what kind of IOStream is returned.