Error struct

Returns the calling thread's last error (errno).

Syntax

static Type GetLastError() noexcept;

Return value

Type: Type

The thread's errno.

See also

GetError

Turns the result of a call into an ErrorCode.

Syntax

static Type GetError(bool succeeded) noexcept;

Parameters

succeededbool

Whether the call succeeded.

Return value

Type: Type

Success if it did, else GetLastError.

Remarks

Returns whether error is Success.

Syntax

static constexpr bool Succeeded(Type error) noexcept;

Parameters

errorType

A POSIX error code.

Return value

Type: bool

true if error is Success; otherwise false.

See also

Failed

Returns whether error is anything but Success.

Syntax

static constexpr bool Failed(Type error) noexcept;

Parameters

errorType

A POSIX error code.

Return value

Type: bool

true for every code other than Success; otherwise false.

See also

Succeeded

Returns whether error is Pending.

Syntax

static constexpr bool IsPending(Type error) noexcept;

Parameters

errorType

A POSIX error code.

Return value

Type: bool

true if error is Pending; otherwise false.

Returns whether error means the kernel takes no more operations for now.

Syntax

static constexpr bool TooManyAsynchronousRequests(Type error) noexcept;

Parameters

errorType

A POSIX error code.

Return value

Type: bool

true for EAGAIN and EBUSY; otherwise false.

Remarks

Returns whether error is EndOfStream.

Syntax

static constexpr bool IsEndOfStream(Type error) noexcept;

Parameters

errorType

A POSIX error code.

Return value

Type: bool

true if error is EndOfStream; otherwise false.

Turns the result of an asynchronous operation of the core into an error code.

Syntax

static constexpr Type FromResult(std::int32_t result) noexcept;

Parameters

resultstd::int32_t

What the completion routine received: a byte count, or a negated errno.

Return value

Type: Type

Success for a byte count; otherwise the errno.

A POSIX error code (an errno value).

Syntax

using Type = int;

0: the operation succeeded.

Syntax

static constexpr Type Success = 0;

A read started at or beyond the end of the file (made up: Linux reads 0 bytes there).

Syntax

static constexpr Type EndOfFile = -1;

Same value as EndOfFile, for streams and sockets.

Syntax

static constexpr Type EndOfStream = EndOfFile;

See also

IsEndOfStream

An asynchronous operation was started and completes later (made up).

Syntax

static constexpr Type Pending = -2;

See also

IsPending

EBADF: not an open file or socket.

Syntax

static constexpr Type InvalidHandle = EBADF;

EFAULT: a buffer address is outside the process's memory.

Syntax

static constexpr Type InvalidUserBuffer = EFAULT;

ENOMEM: not enough memory.

Syntax

static constexpr Type NotEnoughMemory = ENOMEM;

EINVAL: a parameter is not valid.

Syntax

static constexpr Type InvalidParameter = EINVAL;

ENOENT: nothing of that name.

Syntax

static constexpr Type NotFound = ENOENT;

ENOENT: the file does not exist.

Syntax

static constexpr Type FileNotFound = ENOENT;

EIO: the device could not write (also: a write that transferred less than asked).

Syntax

static constexpr Type WriteFault = EIO;

EBADF, as WSAEBADF.

Syntax

static constexpr Type BadDescriptor = EBADF;

EMFILE: the process has too many open files.

Syntax

static constexpr Type TooManyOpenFiles = EMFILE;

EWOULDBLOCK: a non-blocking call would have to wait.

Syntax

static constexpr Type WouldBlock = EWOULDBLOCK;

EINPROGRESS: a non-blocking connect is under way.

Syntax

static constexpr Type InProgress = EINPROGRESS;

EALREADY: an operation of this kind is already under way.

Syntax

static constexpr Type AlreadyInProgress = EALREADY;

ENOTSOCK: the descriptor is no socket.

Syntax

static constexpr Type NotSocket = ENOTSOCK;

EMSGSIZE: a message too long for the socket.

Syntax

static constexpr Type MessageSize = EMSGSIZE;

EPROTOTYPE: a protocol that does not fit the socket type.

Syntax

static constexpr Type ProtocolType = EPROTOTYPE;

ENOPROTOOPT: an unknown socket option.

Syntax

static constexpr Type ProtocolOption = ENOPROTOOPT;

EOPNOTSUPP: the operation is not supported (also: the kernel cannot cancel by file).

Syntax

static constexpr Type OperationNotSupported = EOPNOTSUPP;

EAFNOSUPPORT: an address family not supported.

Syntax

static constexpr Type AddressFamilyNotSupported = EAFNOSUPPORT;

EADDRINUSE: the address is in use.

Syntax

static constexpr Type AddressInUse = EADDRINUSE;

EADDRNOTAVAIL: the address is not available on this host.

Syntax

static constexpr Type AddressNotAvailable = EADDRNOTAVAIL;

ECONNABORTED: the connection was aborted on this side.

Syntax

static constexpr Type ConnectionAborted = ECONNABORTED;

ECONNRESET: the peer reset the connection.

Syntax

static constexpr Type ConnectionReset = ECONNRESET;

ENOTCONN: the socket is not connected.

Syntax

static constexpr Type NotConnected = ENOTCONN;

ECONNREFUSED: nothing listens at the address.

Syntax

static constexpr Type ConnectionRefused = ECONNREFUSED;

ECANCELED: the operation was cancelled before it completed.

Syntax

static constexpr Type OperationAborted = ECANCELED;

ETIMEDOUT: an operation with a timeout ran out of time.

Syntax

static constexpr Type TimedOut = ETIMEDOUT;

Same value as TimedOut; Windows tells a wait's timeout apart.

Syntax

static constexpr Type WaitTimedOut = ETIMEDOUT;