Socket¶

1

import "std/net/socket";

InAddr struct¶

Represents an IPv4 address

In6Addr struct¶

Represents an IPv6 address

SockAddrIn struct¶

Socket address for an IPv4 (AF_INET) endpoint

SockAddrIn6 struct¶

Socket address for an IPv6 (AF_INET6) endpoint

SockAddrUn struct¶

Socket address for a Unix domain (AF_UNIX) endpoint

Socket struct¶

A network socket, wrapping the listening socket file descriptor and the current connection

Methods¶

acceptConnection¶

1

public f<Result<int>> Socket.acceptConnection()

Accept an incoming connection to the socket and save the connection file desceiptor to the socket object.

Returns: Result<int> — Connection file descriptor

write¶

1

public f<long> Socket.write(string message)

Write a raw string to the socket.

Parameters

Returns: long — Number of bytes written

write¶

1

public f<long> Socket.write(byte* content, unsigned long size)

Write an array of bytes to the socket. Note: The given buffer needs to be at least of the given size.

Parameters

Returns: long — Number of bytes written

read¶

1

public f<long> Socket.read(byte* buffer, long size)

Read n bytes from the socket to the given buffer. Note: The given buffer needs to be at least of the given size.

Parameters

Returns: long — Number of bytes written

close¶

1

public f<bool> Socket.close()

Closes the socket. This method should always be called by the user before exiting the program.

Returns: bool — Closing the connection was successful or not

Functions¶

openServerSocket¶

1

public f<Result<Socket>> openServerSocket(unsigned short port, int maxWaitingConnections = 5)

Opens a TCP server socket and exposes it to the given port. The maxWaitingConnections defines the maximum length to which the queue of pending connections may grow. If a connection request arrives when the queue is full, the client may receive an error with an indication of ECONNREFUSED or, if the underlying protocol support retransmission, the request may be ignored so that a later reattempt at connection succeeds.

Parameters

Returns: Result<Socket> — Socket file descriptor

openClientSocket¶

1

public f<Result<Socket>> openClientSocket(string host, unsigned short port)

Opens a TCP client socket and tries to connect it to a server socket.

Parameters

Returns: Result<Socket> — Socket file descriptor

InAddrT alias¶

Alias for unsigned int.

InPortT alias¶

Alias for unsigned short.