Foreign.Lua.Core.Error

Lua exceptions and exception handling.

Documentation

newtype Exception

Exceptions raised by Lua-related operations.

Constructors

Exception

Fields

• exceptionMessage :: String

Instances

Eq Exception

Defined in Foreign.Lua.Core.Error

Methods

(==) :: Exception -> Exception -> Bool

(/=) :: Exception -> Exception -> Bool

Show Exception

Defined in Foreign.Lua.Core.Error

Methods

showsPrec :: Int -> Exception -> ShowS

show :: Exception -> String

showList :: [Exception] -> ShowS

Exception Exception

Defined in Foreign.Lua.Core.Error

Methods

toException :: Exception -> SomeException

fromException :: SomeException -> Maybe Exception

displayException :: Exception -> String

catchException :: Lua a -> (Exception -> Lua a) -> Lua a

Catch a Lua Exception.

throwException :: String -> Lua a

Raise a Lua Exception containing the given error message.

withExceptionMessage :: (String -> String) -> Lua a -> Lua a

Catch Lua Exception, alter the message and rethrow.

throwErrorAsException :: Lua a

Convert a Lua error into a Haskell exception. The error message is expected to be at the top of the stack.

throwTopMessage :: Lua a

Alias for throwErrorAsException; will be deprecated in the next mayor release.

throwTopMessageWithState :: State -> IO a

Convert the object at the top of the stack into a string and throw it as a HsLua Exception.

This function serves as the default to convert Lua errors to Haskell exceptions.

errorMessage :: State -> IO ByteString

Retrieve and pop the top object as an error message. This is very similar to tostring', but ensures that we don't recurse if getting the message failed.

try :: Lua a -> Lua (Either Exception a)

Return either the result of a Lua computation or, if an exception was thrown, the error.

Helpers for hslua C wrapper functions.

throwMessage :: String -> Lua a

Helper function which uses proper error-handling to throw an exception with the given message.

liftLuaThrow :: (State -> Ptr StatusCode -> IO a) -> Lua a

Takes a failable HsLua function and transforms it into a monadic Lua operation. Throws an exception if an error occured.

Orphan instances

Alternative Lua

Methods

empty :: Lua a

(<|>) :: Lua a -> Lua a -> Lua a

some :: Lua a -> Lua [a]

many :: Lua a -> Lua [a]