std/network

import "std/network" as network;

Stream API

var stream = network.dial("example.com", 80);
if !stream.isOpen() {
    return 1;
}

stream.sendAll("GET / HTTP/1.0\r\nHost: example.com\r\n\r\n");
var response = stream.recv(4096);
stream.close();

Stream methods include fdValue(), isOpen(), close(), send(data), sendAll(data), sendLine(line), recv(maxLen), recvExact(bytes), recvUntil(delimiter, maxLen), recvLine(maxLen), readBufferedBytes(), and clearBuffer().

Listener provides fdValue, isOpen, accept, and close. Create one with bind(host, port) or bindEndpoint(endpoint).

Raw wrappers

The module also exposes descriptor-based functions: endpoint, connect, connectEndpoint, dial, dialEndpoint, listen, bind, bindEndpoint, accept, send, recv, resolve, closeIfOpen, isValidFd, okCode, invalidFd, lastErrorCode, makeError, and lastError. Lower-level netAccept, netClose, netSend, and netRecv are available too, along with the netConnect, netListen, and netResolve runtime declarations.

Most operations report failure through a negative descriptor, a return code, or lastErrorCode(). The current API does not use Zap failable return types. Always check the result and close every open stream or listener.