std.net
TCP networking module with connection and listener support.
Phase 125A added real TCP socket client/server building blocks based on the
net_* runtime builtins (available on both engines). The module wraps
raw fd-based builtins behind friendly types.
Note
Every networking function returns -1 (or “”) on failure and leaves a
deterministic last-error string readable via net_error(). Blocking
reads time out after 5 seconds.
Types
Address{ host, port }— a single socket endpointEndpoint{ host, port, kind }— an address with a TCP schemeConnectionInteger fd from
net_dial/net_accept_nextListenerInteger fd from
net_serve
Functions
Connection management
net_address(host, port)Build an Address value
net_endpoint(host, port)Build an Endpoint value with TCP scheme
net_dial(point)Open TCP connection to Address/Endpoint (returns fd or -1)
net_serve(point)Bind and listen on Address/Endpoint (returns Listener fd or -1)
net_accept_next(listener)Block for next pending connection (returns Connection fd or -1)
net_close(fd)Close a connection or listener
Data transfer
net_send(fd, data)Send data over connection (returns bytes sent or -1)
net_recv(fd, max_bytes)Receive data (returns string or “” on failure)
net_send_all(fd, data)Send all data (blocks until complete or error)
net_recv_line(fd)Receive until newline (returns string or “” on error)
Error handling
net_error()Last error message (empty on success)
net_fd_open(fd)Check if fd is valid (>= 0)
Example
import std.net
func main() {
let addr = net_address("127.0.0.1", "8080")
let conn = net_dial(addr)
if (conn >= 0) {
net_send(conn, "hello")
net_close(conn)
}
}
See examples/04-networking/ for complete TCP echo and roundtrip examples.