mioco 0.8.1

Scalable, asynchronous IO coroutine-based handling (aka MIO COroutines).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

use super::RW;
use super::evented::{EventedImpl, MioAdapter};
use mio_orig;
use std::io;
use std::net::SocketAddr;

pub use mio_orig::IpAddr;

/// Udp Socket
pub type UdpSocket = MioAdapter<mio_orig::udp::UdpSocket>;

impl UdpSocket {
    /// Return a new unbound IPv4 UDP Socket.
    pub fn v4() -> io::Result<Self> {
        mio_orig::udp::UdpSocket::v4().map(MioAdapter::new)
    }

    /// Return a new unbound IPv6 UDP Socket.
    pub fn v6() -> io::Result<Self> {
        mio_orig::udp::UdpSocket::v6().map(MioAdapter::new)
    }

    /// Return a new bound UDP Socket.
    pub fn bound(addr: &SocketAddr) -> io::Result<Self> {
        mio_orig::udp::UdpSocket::bound(addr).map(MioAdapter::new)
    }

    /// Bind the unbound UDP Socket.
    pub fn bind(&self, addr: &SocketAddr) -> io::Result<()> {
        self.shared().io_ref().bind(addr)

    }

    /// Local address of the Socket.
    pub fn local_addr(&self) -> io::Result<SocketAddr> {
        self.shared().io_ref().local_addr()
    }

    /// Try cloning the socket.
    pub fn try_clone(&self) -> io::Result<UdpSocket> {
        self.shared().io_ref().try_clone().map(MioAdapter::new)
    }

    /// Block on recv.
    pub fn recv(&mut self, buf: &mut [u8]) -> io::Result<(usize, SocketAddr)> {
        loop {
            let res = self.try_recv(buf);

            match res {
                Ok(None) => self.block_on_prv(RW::read()),
                Ok(Some(r)) => {
                    return Ok(r);
                }
                Err(e) => return Err(e),
            }
        }
    }

    /// Try reading data into a buffer.
    ///
    /// This will not block.
    pub fn try_recv(&mut self, buf: &mut [u8]) -> io::Result<Option<(usize, SocketAddr)>> {
        self.shared().io_ref().recv_from(buf)
    }

    /// Block on send.
    pub fn send(&mut self, buf: &[u8], target: &SocketAddr) -> io::Result<usize> {
        loop {
            let res = self.try_send(buf, target);

            match res {
                Ok(None) => self.block_on_prv(RW::write()),
                Ok(Some(r)) => {
                    return Ok(r);
                }
                Err(e) => return Err(e),
            }
        }
    }

    /// Try writing a data from the buffer.
    ///
    /// This will not block.
    pub fn try_send(&self, buf: &[u8], target: &SocketAddr) -> io::Result<Option<usize>> {
        self.shared().io_ref().send_to(buf, target)
    }

    /// Set broadcast flag.
    pub fn set_broadcast(&self, on: bool) -> io::Result<()> {
        self.shared().io_ref().set_broadcast(on)
    }

    /// Set multicast loop flag.
    pub fn set_multicast_loop(&self, on: bool) -> io::Result<()> {
        self.shared().io_ref().set_multicast_loop(on)
    }

    /// Join multicast.
    pub fn join_multicast(&self, multi: &IpAddr) -> io::Result<()> {
        self.shared().io_ref().join_multicast(multi)
    }

    /// Leave multicast.
    pub fn leave_multicast(&self, multi: &IpAddr) -> io::Result<()> {
        self.shared().io_ref().leave_multicast(multi)
    }

    /// Set multicast TTL.
    pub fn set_multicast_time_to_live(&self, ttl: i32) -> io::Result<()> {
        self.shared().io_ref().set_multicast_time_to_live(ttl)
    }
}