built-in method

resource_error/1

Description

resource_error(Resource)

Throws a resource error. Used when a required resource (e.g. memory or disk space) to complete execution is not available. This built-in method is declared private and thus cannot be used as a message to an object. Calling this predicate is equivalent to the following sequence of goals:

...,
context(Context),
throw(error(resource_error(Resource), Context)).

This allows the user to generate errors in the same format used by the runtime.

Possible values for Resource include:

  • threads

  • coinduction

  • soft_cut_support

Modes and number of proofs

resource_error(@nonvar) - error

Errors

When called:
resource_error(Resource)

Examples

...,
empty(Tank),
resource_error(gas).

See also

catch/3, throw/1, context/1, instantiation_error/0, uninstantiation_error/1, type_error/2, domain_error/2, existence_error/2, permission_error/3, representation_error/1, syntax_error/1, system_error/0