Error Handling

Centralized exception throwing utilities. More...

Collaboration diagram for Error Handling:

Functions
template<std::derived_from< MagicException > ExceptionT, typename ResultT, typename... ExceptionArgsT> requires std::same_as<ResultT, int> || std::same_as<ResultT, bool>
static void	Recognition::Magic::MagicPrivate::ThrowExceptionOnFailure (ResultT result, ExceptionArgsT &&... args)
	Centralized error handling template.

Detailed Description

Centralized exception throwing utilities.

Template-based error handling for consistent exception throwing across all MagicPrivate methods.

Function Documentation

ThrowExceptionOnFailure()

template<std::derived_from< MagicException > ExceptionT, typename ResultT, typename... ExceptionArgsT>
requires std::same_as<ResultT, int> || std::same_as<ResultT, bool>

void Recognition::Magic::MagicPrivate::ThrowExceptionOnFailure ( ResultT result, ExceptionArgsT &&... args )

inlinestatic

Centralized error handling template.

Throws an exception of type ExceptionT if the result indicates failure. Works with both boolean and integer result types.

Template Parameters

ExceptionT	Exception type derived from MagicException.
ResultT	Either int or bool.
ExceptionArgsT	Types of exception constructor arguments.

Parameters

[in]	result	Result to check (false or LIBMAGIC_ERROR = failure).
[in]	args	Arguments forwarded to ExceptionT constructor.

Exceptions

ExceptionT

If result is false (bool) or -1 (int).

Usage Examples

// Boolean check - throws if false
ThrowExceptionOnFailure<MagicIsClosed>(IsOpen());
 
// Integer check - throws if -1
ThrowExceptionOnFailure<MagicOpenError>(result, GetErrorMessage());
 
// With additional exception arguments
ThrowExceptionOnFailure<PathDoesNotExist>(
    std::filesystem::exists(path), path.string()
);

See also

MagicException