Struct std::net::unix::TcpStream

A TCP connection

Example

use std::net::{NameLookup, TcpStream, Shutdown};
use std::io::{Result, StdioStream, copy};

fn http_fetch() -> Result<()> {
    let addrs = NameLookup::resolve("docs.alumina-lang.net", 80)?;
    defer addrs.free();

    let socket = TcpStream::connect(&addrs.next().unwrap())?;
    defer socket.close();

    socket.write_all("GET / HTTP/1.1\r\n")?;
    socket.write_all("Host: docs.alumina-lang.net\r\n")?;
    socket.write_all("Connection: close\r\n\r\n")?;

    socket.shutdown(Shutdown::Write)?;

    copy(&socket, &StdioStream::stdout())?;

    Result::ok(())
}

http_fetch().unwrap();
Run this example

Fields

• socket: Socket

Methods

• fn connect(addr: &SocketAddr) -> Result<TcpStream>

  source

  Establishes a TCP connection to a remote host.

• fn from_socket(socket: Socket) -> TcpStream

  source

  Create a new TCP stream from a raw socket

• fn as_fd(self: &TcpStream) -> FileDescriptor

  source

• fn peer_addr(self: &TcpStream) -> Result<SocketAddr>

  source

  Returns the address of the remote peer

• fn socket_addr(self: &TcpStream) -> Result<SocketAddr>

  source

  Returns the address of the remote peer

• fn shutdown(self: &TcpStream, how: Shutdown) -> Result<()>

  source

  Shuts down the reading or writing end of the socket or both.

• fn read(self: &mut TcpStream, buf: &mut [u8]) -> Result<usize>

  source

  Reads from the stream into a provided buffer.

  If successful, returns the number of bytes read. This may be less than the size of the provided buffer.

• fn write(self: &mut TcpStream, buf: &[u8]) -> Result<usize>

  source

  Write the buffer to the stream.

  Returns the number of bytes written. This may be less than the size of the buffer. See also write_all, which can be used to write the entire buffer.

• fn flush(self: &mut TcpStream) -> Result<()>

  source

  Flush the stream

  This may be a no-op, depending on the stream.

• fn close(self: &mut TcpStream) -> Result<()>

  source

  Closes the socket.

• fn move(self: &mut TcpStream) -> TcpStream

  source

  Creates a copy of the object, leaving an inert object behind.

  See Movable for details.

Mixins

• mixin Readable<TcpStream>

• fn read_exact(self: &mut Self, buf: &mut [u8]) -> Result<()>

  source

  Fills the provided buffer by reading from the stream.

  If stream had less bytes available than the size of the buffer, this method will return an Error::eof().

• fn read_to_end(self: &mut Self, buf: &mut StringBuf) -> Result<usize>

  source

  Reads the entire stream into a StringBuf.

  If successful, returns the number of bytes that were read.

• mixin Writable<TcpStream>

• fn write_all(self: &mut Self, buf: &[u8]) -> Result<()>

  source

  Writes all the bytes in the buffer to the stream.

  If EOF is reached, returns Error::eof().