std.net.udp

datagram sockets; send_to/recv_from, or connect once then send/recv

Datagram

pub Datagram :: struct {
    len: usize,
    from: addr::SocketAddr,
}

recv_from result: byte count + sender

UdpSocket

pub UdpSocket :: struct {
    sock: socket::Socket,
}

UdpSocket.send_to

pub send_to :: fn(self: *Self, data: []const u8, to: addr::SocketAddr) -> usize ! NetError

one datagram to to; bytes sent

UdpSocket.recv_from

pub recv_from :: fn(self: *Self, buf: []u8) -> Datagram ! NetError

one datagram into buf; truncated if longer than buf

UdpSocket.connect

pub connect :: fn(self: *Self, to: addr::SocketAddr) -> void ! NetError

default peer for send/recv; drops datagrams from others

UdpSocket.send

pub send :: fn(self: *Self, data: []const u8) -> usize ! NetError

to the connected peer; must call connect first

UdpSocket.recv

pub recv :: fn(self: *Self, buf: []u8) -> usize ! NetError

from the connected peer; bytes read

UdpSocket.set_broadcast

pub set_broadcast :: fn(self: *Self, on: bool) -> void ! NetError

UdpSocket.set_read_timeout

pub set_read_timeout :: fn(self: *Self, ms: i32) -> void ! NetError

UdpSocket.local_addr

pub local_addr :: fn(self: *Self) -> addr::SocketAddr ! NetError

UdpSocket.close

pub close :: fn(self: *Self)

bind

pub bind :: fn(sa: addr::SocketAddr) -> UdpSocket ! NetError

udp socket bound to sa; sets SO_REUSEADDR

unbound

pub unbound :: fn() -> UdpSocket ! NetError

unbound socket; the os picks a port on first send