[][src]Function tokio_tls_api::connect_async

pub fn connect_async<C, S>(
    connector: &C,
    domain: &str,
    stream: S
) -> ConnectAsync<S> where
    S: Read + Write + Debug + Send + Sync + 'static,
    C: TlsConnector

Connects the provided stream with this connector, assuming the provided domain.

This function will internally call TlsConnector::connect to connect the stream and returns a future representing the resolution of the connection operation. The returned future will resolve to either TlsStream<S> or Error depending if it's successful or not.

This is typically used for clients who have already established, for example, a TCP connection to a remote server. That stream is then provided here to perform the client half of a connection to a TLS-powered server.

Compatibility notes

Note that this method currently requires S: Read + Write but it's highly recommended to ensure that the object implements the AsyncRead and AsyncWrite traits as well, otherwise this function will not work properly.