Next: Dynamic Wind, Previous: Exceptions, Up: Control Mechanisms
Guile provides a set of convenience procedures for signaling error conditions that are implemented on top of the exception primitives just described.
Raise an error with key
misc-error
and a message constructed by displaying msg and writing args.
Raise an error with key key. subr can be a string naming the procedure associated with the error, or
#f
. message is the error message string, possibly containing~S
and~A
escapes. When an error is reported, these are replaced by formatting the corresponding members of args:~A
(was%s
in older versions of Guile) formats usingdisplay
and~S
(was%S
) formats usingwrite
. data is a list or#f
depending on key: if key issystem-error
then it should be a list containing the Unixerrno
value; If key issignal
then it should be a list containing the Unix signal number; If key isout-of-range
orwrong-type-arg
, it is a list containing the bad value; otherwise it will usually be#f
.
Return the Unix error message corresponding to err, an integer
errno
value.When
setlocale
has been called (see Locales), the message is in the language and charset ofLC_MESSAGES
. (This is done by the C library.)