Display the source code in std/exception.d from which this page was generated on github.

If you spot a problem with this page, click here to create a Bugzilla issue.

Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Class `std.exception.ErrnoException`

Thrown if errors that set errno occur.


						
				class ErrnoException
				
  : Exception
				;

Constructors

Name	Description
`this`	Constructor which takes an error message. The current global `core.stdc.errno.errno` value is used as error code.
`this`	Constructor which takes an error message and error code.

Fields

Name	Type	Description
`file`	`string`	The file name of the D source code corresponding with where the error was thrown from.
`info`	`object.Throwable.TraceInfo`	The stack trace of where the error happened. This is an opaque object that can either be converted to `string`, or iterated over with `foreach` to extract the items in the stack trace (as strings).
`line`	`ulong`	The line number of the D source code corresponding with where the error was thrown from.
`msg`	`string`	A message describing the error.

Properties

Name	Type	Description
`errno`[get]	`uint`	Operating system error code.
`next`[get]	`inout(Throwable)`
`next`[set]	`Throwable`	Replace next in chain with `tail`. Use `chainTogether` instead if at all possible.

Methods

Name	Description
`chainTogether`	Append `e2` to chain of exceptions that starts with `e1`.
`factory`	Create instance of class specified by the fully qualified name classname. The class must either have no constructors or have a default constructor.
`message`	Get the message describing the error. Base behavior is to return the `Throwable.msg` field. Override to return some other error message.
`opApply`	Loop over the chain of Throwables.
`opCmp`	Compare with another Object obj.
`opEquals`	Test whether `this` is equal to `o`. The default implementation only compares by identity (using the `is` operator). Generally, overrides for `opEquals` should attempt to compare objects by their contents.
`refcount`
`toHash`	Compute hash function for Object.
`toString`	Overrides `Object.toString` and returns the error message. Internally this forwards to the `toString` overload that takes a sink delegate.
`toString`	The Throwable hierarchy uses a toString overload that takes a sink delegate to avoid GC allocations, which cannot be performed in certain error situations. Override this `toString` method to customize the error message.

Example

import core.stdc.errno : EAGAIN;
auto ex = new ErrnoException("oh no", EAGAIN);
writeln(ex.errno); // EAGAIN

Example

errno is used by default if no explicit error code is provided

import core.stdc.errno : errno, EAGAIN;

auto old = errno;
scope(exit) errno = old;

// fake that errno got set by the callee
errno = EAGAIN;
auto ex = new ErrnoException("oh no");
writeln(ex.errno); // EAGAIN

Authors

Andrei Alexandrescu and Jonathan M Davis

License

Boost License 1.0

API Documentation

Class std.exception.ErrnoException

Constructors

Fields

Properties

Methods

Example

Example

Authors

License

Class `std.exception.ErrnoException`