The std/oserrors module implements OS error reporting.

Imports

Types

OSErrorCode = distinct int32

Specifies an OS Error Code. Source Edit

Procs

proc `$`(err: OSErrorCode): string {.borrow, ...raises: [], tags: [], forbids: [].}

Source Edit

proc `==`(err1, err2: OSErrorCode): bool {.borrow, ...raises: [], tags: [],
    forbids: [].}

Source Edit

proc newOSError(errorCode: OSErrorCode; additionalInfo = ""): owned(ref OSError) {.
    noinline, ...raises: [], tags: [], forbids: [].}

Creates a new OSError exception.

The errorCode will determine the message, osErrorMsg proc will be used to get this message.

The error code can be retrieved using the osLastError proc.

If the error code is 0 or an error message could not be retrieved, the message unknown OS error will be used.

See also:

raiseOSError proc“)
osLastError proc

Example:

when defined(linux):
  assert osErrorMsg(OSErrorCode(0)) == ""
  assert osErrorMsg(OSErrorCode(1)) == "Operation not permitted"
  assert osErrorMsg(OSErrorCode(2)) == "No such file or directory"

Source Edit

proc osLastError(): OSErrorCode {.sideEffect, ...raises: [], tags: [], forbids: [].}

Retrieves the last operating system error code.

This procedure is useful in the event when an OS call fails. In that case this procedure will return the error code describing the reason why the OS call failed. The OSErrorMsg procedure can then be used to convert this code into a string.

Warning: The behaviour of this procedure varies between Windows and POSIX systems. On Windows some OS calls can reset the error code to 0 causing this procedure to return 0. It is therefore advised to call this procedure immediately after an OS call fails. On POSIX systems this is not a problem.