LuaSkinDelegate

Extends Protocol:
NSObject
Declared In:

Introduction

Delegate method for passing control back to the parent environment for environment specific handling. Currently only offers support for passing log messages back to the parent environment for display or processing.



Methods

-handleCatastrophe:

LuaSkin has been unable to perform a vital operation, the delegate should make the attached message visible to the user and then exit

-logForLuaSkinAtLevel:withMessage:

Pass log level and message back to parent for handling and/or display

-logKnownBug:

Log a known, but avoided issue via the log delegate, primarily to ensure it can be recorded in a crash reporting service


handleCatastrophe:


LuaSkin has been unable to perform a vital operation, the delegate should make the attached message visible to the user and then exit

- (void)handleCatastrophe:(NSString *)message; 
Parameters
message

A message to display to the user


logForLuaSkinAtLevel:withMessage:


Pass log level and message back to parent for handling and/or display

@optional

- (void)logForLuaSkinAtLevel:(int)level withMessage:(NSString *)theMessage;
Parameters
level

The message log level as an integer. Predefined levels are defined and used within LuaSkin itself as (in decreasing level of severity) LS_LOG_ERROR, LS_LOG_WARN, LS_LOG_INFO, LS_LOG_DEBUG, and LS_LOG_VERBOSE.

theMessage

The text of the message to be logged.

Discussion

If no delegate has been assigned, the message is logged to the system logs via NSLog.


logKnownBug:


Log a known, but avoided issue via the log delegate, primarily to ensure it can be recorded in a crash reporting service

@optional

- (void)logKnownBug:(NSString *)message, ...;
Parameters
message

The message to log

Discussion

If no delegate has been assigned, the message is logged to the system logs via NSLog.