src/OFApplication.h

/*
 * Copyright (c) 2008, 2009, 2010, 2011, 2012
 *   Jonathan Schleifer <js@webkeks.org>
 *
 * All rights reserved.
 *
 * This file is part of ObjFW. It may be distributed under the terms of the
 * Q Public License 1.0, which can be found in the file LICENSE.QPL included in
 * the packaging of this file.
 *
 * Alternatively, it may be distributed under the terms of the GNU General
 * Public License, either version 2 or 3, which can be found in the file
 * LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
 * file.
 */

#import "OFObject.h"

@class OFString;
@class OFArray;
@class OFDictionary;
@class OFMutableArray;
@class OFMutableDictionary;

#define OF_APPLICATION_DELEGATE(cls)                                    \
        int                                                             \
        main(int argc, char *argv[])                                    \
        {                                                               \
                return of_application_main(&argc, &argv, [cls class]);  \
        }

#ifndef OF_APPLICATION_M
@protocol OFApplicationDelegate <OFObject>
#else
@protocol OFApplicationDelegate
#endif

- (void)applicationDidFinishLaunching;

#ifdef OF_HAVE_OPTIONAL_PROTOCOLS
@optional
#endif

- (void)applicationWillTerminate;

- (void)applicationDidReceiveSIGINT;

#ifndef _WIN32

- (void)applicationDidReceiveSIGHUP;

- (void)applicationDidReceiveSIGUSR1;

- (void)applicationDidReceiveSIGUSR2;
#endif
@end

@interface OFApplication: OFObject
{
        OFString *programName;
        OFMutableArray *arguments;
        OFMutableDictionary *environment;
        int *argc;
        char ***argv;
@public
        id <OFApplicationDelegate> delegate;
        void (*SIGINTHandler)(id, SEL);
#ifndef _WIN32
        void (*SIGHUPHandler)(id, SEL);
        void (*SIGUSR1Handler)(id, SEL);
        void (*SIGUSR2Handler)(id, SEL);
#endif
}

#ifdef OF_HAVE_PROPERTIES
@property (readonly, assign) OFString *programName;
@property (readonly, assign) OFArray *arguments;
@property (readonly, assign) OFDictionary *environment;
@property (assign) id <OFApplicationDelegate> delegate;
#endif

+ sharedApplication;

+ (OFString*)programName;

+ (OFArray*)arguments;

+ (OFDictionary*)environment;

+ (void)terminate;

+ (void)terminateWithStatus: (int)status;

- (void)setArgumentCount: (int*)argc
       andArgumentValues: (char**[])argv;

- (void)getArgumentCount: (int**)argc
       andArgumentValues: (char***[])argv;

- (OFString*)programName;

- (OFArray*)arguments;

- (OFDictionary*)environment;

- (id <OFApplicationDelegate>)delegate;

- (void)setDelegate: (id <OFApplicationDelegate>)delegate;

- (void)run;

- (void)terminate;

- (void)terminateWithStatus: (int)status;
@end

@interface OFObject (OFApplicationDelegate) <OFApplicationDelegate>
@end

#ifdef __cplusplus
extern "C" {
#endif
extern int of_application_main(int*, char**[], Class);
#ifdef __cplusplus
}
#endif