ObjFW
Instance Methods | Class Methods | Properties | List of all members
OFApplication Class Reference

A class which represents the application as an object. More...

#import <ObjFW/OFApplication.h>

Inheritance diagram for OFApplication:
OFObject <OFObject>

Instance Methods

(void) - getArgumentCount:andArgumentValues:
 Gets argc and argv. More...
 
(nullable id< OFApplicationDelegate >) - delegate
 Returns the delegate of the application. More...
 
(void) - setDelegate:
 Sets the delegate of the application. More...
 
(void) - terminate
 Terminates the application.
 
(void) - terminateWithStatus:
 Terminates the application with the specified status. More...
 
(void) - activateSandbox:
 Activates the specified sandbox for the application. More...
 
- Instance Methods inherited from OFObject
(id) - init
 Initializes an already allocated object. More...
 
(OFString *) - className
 Returns the name of the object's class. More...
 
(OFString *) - description
 Returns a description for the object. More...
 
(nullable void *) - allocMemoryWithSize:
 Allocates memory and stores it in the object's memory pool. More...
 
(nullable void *) - allocMemoryWithSize:count:
 Allocates memory for the specified number of items and stores it in the object's memory pool. More...
 
(nullable void *) - resizeMemory:size:
 Resizes memory in the object's memory pool to the specified size. More...
 
(nullable void *) - resizeMemory:size:count:
 Resizes memory in the object's memory pool to the specific number of items of the specified size. More...
 
(void) - freeMemory:
 Frees allocated memory and removes it from the object's memory pool. More...
 
(void) - dealloc
 Deallocates the object. More...
 
(void) - performSelector:afterDelay:
 Performs the specified selector after the specified delay. More...
 
(void) - performSelector:withObject:afterDelay:
 Performs the specified selector with the specified object after the specified delay. More...
 
(void) - performSelector:withObject:withObject:afterDelay:
 Performs the specified selector with the specified objects after the specified delay. More...
 
(void) - performSelector:onThread:waitUntilDone:
 Performs the specified selector on the specified thread. More...
 
(void) - performSelector:onThread:withObject:waitUntilDone:
 Performs the specified selector on the specified thread with the specified object. More...
 
(void) - performSelector:onThread:withObject:withObject:waitUntilDone:
 Performs the specified selector on the specified thread with the specified objects. More...
 
(void) - performSelectorOnMainThread:waitUntilDone:
 Performs the specified selector on the main thread. More...
 
(void) - performSelectorOnMainThread:withObject:waitUntilDone:
 Performs the specified selector on the main thread with the specified object. More...
 
(void) - performSelectorOnMainThread:withObject:withObject:waitUntilDone:
 Performs the specified selector on the main thread with the specified objects. More...
 
(void) - performSelector:onThread:afterDelay:
 Performs the specified selector on the specified thread after the specified delay. More...
 
(void) - performSelector:onThread:withObject:afterDelay:
 Performs the specified selector on the specified thread with the specified object after the specified delay. More...
 
(void) - performSelector:onThread:withObject:withObject:afterDelay:
 Performs the specified selector on the specified thread with the specified objects after the specified delay. More...
 
(nullable id) - forwardingTargetForSelector:
 This method is called when resolveClassMethod: or resolveInstanceMethod: returned false. It should return a target to which the message should be forwarded. More...
 
(void) - doesNotRecognizeSelector:
 Handles messages which are not understood by the receiver. More...
 
(OFString *) - stringBySerializing
 Creates a string by serializing the receiver. More...
 
- Instance Methods inherited from <OFObject>
(bool) - isKindOfClass:
 Returns a boolean whether the object of the specified kind. More...
 
(bool) - isMemberOfClass:
 Returns a boolean whether the object is a member of the specified class. More...
 
(bool) - respondsToSelector:
 Returns a boolean whether the object responds to the specified selector. More...
 
(nullable IMP) - methodForSelector:
 Returns the implementation for the specified selector. More...
 
(nullable const char *) - typeEncodingForSelector:
 Returns the type encoding for the specified selector. More...
 
(nullable id) - performSelector:
 Performs the specified selector. More...
 
(nullable id) - performSelector:withObject:
 Performs the specified selector with the specified object. More...
 
(nullable id) - performSelector:withObject:withObject:
 Performs the specified selector with the specified objects. More...
 
(bool) - isEqual:
 Checks two objects for equality. More...
 
(uint32_t) - hash
 Calculates a hash for the object. More...
 
(id) - retain
 Increases the retain count. More...
 
(unsigned int) - retainCount
 Returns the retain count. More...
 
(void) - release
 Decreases the retain count. More...
 
(id) - autorelease
 Adds the object to the topmost OFAutoreleasePool of the thread's autorelease pool stack. More...
 
(id) - self
 Returns the receiver. More...
 
(bool) - isProxy
 Returns whether the object is a proxy object. More...
 
(bool) - allowsWeakReference
 Returns whether the class allows weak references. More...
 
(bool) - retainWeakReference
 Retain a weak reference to this object. More...
 

Class Methods

(nullable OFApplication *) + sharedApplication
 Returns the only OFApplication instance in the application. More...
 
(nullable OFString *) + programName
 Returns the name of the program (argv[0]). More...
 
(nullable OFArray *) + arguments
 Returns the arguments passed to the application. More...
 
(nullable OFDictionary *) + environment
 Returns the environment of the application. More...
 
(void) + terminate
 Terminates the application with the EXIT_SUCCESS status.
 
(void) + terminateWithStatus:
 Terminates the application with the specified status. More...
 
(void) + activateSandbox:
 Activates the specified sandbox for the application. More...
 
- Class Methods inherited from OFObject
(void) + load
 A method which is called once when the class is loaded into the runtime. More...
 
(void) + unload
 A method which is called when the class is unloaded from the runtime. More...
 
(void) + initialize
 A method which is called the moment before the first call to the class is being made. More...
 
(id) + alloc
 Allocates memory for an instance of the class and sets up the memory pool for the object. More...
 
(id) + new
 Allocates memory for a new instance and calls init on it. More...
 
(Class) + class
 Returns the class. More...
 
(OFString *) + className
 Returns the name of the class as a string. More...
 
(bool) + isSubclassOfClass:
 Returns a boolean whether the class is a subclass of the specified class. More...
 
(nullable Class) + superclass
 Returns the superclass of the class. More...
 
(bool) + instancesRespondToSelector:
 Checks whether instances of the class respond to a given selector. More...
 
(bool) + conformsToProtocol:
 Checks whether the class conforms to a given protocol. More...
 
(nullable IMP) + instanceMethodForSelector:
 Returns the implementation of the instance method for the specified selector. More...
 
(nullable const char *) + typeEncodingForInstanceSelector:
 Returns the type encoding of the instance method for the specified selector. More...
 
(OFString *) + description
 Returns a description for the class, which is usually the class name. More...
 
(nullable IMP) + replaceClassMethod:withMethodFromClass:
 Replaces a class method with a class method from another class. More...
 
(nullable IMP) + replaceInstanceMethod:withMethodFromClass:
 Replaces an instance method with an instance method from another class. More...
 
(nullable IMP) + replaceClassMethod:withImplementation:typeEncoding:
 Replaces or adds a class method. More...
 
(nullable IMP) + replaceInstanceMethod:withImplementation:typeEncoding:
 Replaces or adds an instance method. More...
 
(void) + inheritMethodsFromClass:
 Adds all methods from the specified class to the class that is the receiver. More...
 
(BOOL) + resolveClassMethod:
 Try to resolve the specified class method. More...
 
(BOOL) + resolveInstanceMethod:
 Try to resolve the specified instance method. More...
 
(id) + copy
 Returns the class. More...
 

Properties

OFStringprogramName
 
OFArrayarguments
 
OFDictionaryenvironment
 

Detailed Description

A class which represents the application as an object.

In order to create a new OFApplication, you should create a class conforming to the optional OFApplicationDelegate protocol and put OF_APPLICATION_DELEGATE(NameOfYourClass) in the .m file of that class. The only required method of the OFApplicationDelegate protocol is OFApplicationDelegate::applicationDidFinishLaunching.

Method Documentation

◆ activateSandbox:() [1/2]

+ (void) activateSandbox: (OFSandbox *)  sandbox

Activates the specified sandbox for the application.

This is only available if OF_HAVE_SANDBOX is defined.

Parameters
sandboxThe sandbox to activate

◆ activateSandbox:() [2/2]

- (void) activateSandbox: (OFSandbox *)  sandbox

Activates the specified sandbox for the application.

This is only available if OF_HAVE_SANDBOX is defined.

Parameters
sandboxThe sandbox to activate

◆ arguments()

+ (nullable OFArray *) arguments

Returns the arguments passed to the application.

Returns
The arguments passed to the application

◆ delegate()

- (id< OFApplicationDelegate >) delegate

Returns the delegate of the application.

Returns
The delegate of the application

◆ environment()

+ (nullable OFDictionary *) environment

Returns the environment of the application.

Returns
The environment of the application

◆ getArgumentCount:andArgumentValues:()

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

Gets argc and argv.

Parameters
argcA pointer where a pointer to argc should be stored
argvA pointer where a pointer to argv should be stored

◆ programName()

+ (nullable OFString *) programName

Returns the name of the program (argv[0]).

Returns
The name of the program (argv[0])

◆ setDelegate:()

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

Sets the delegate of the application.

Parameters
delegateThe delegate for the application

◆ sharedApplication()

+ (OFApplication *) sharedApplication

Returns the only OFApplication instance in the application.

Returns
The only OFApplication instance in the application

◆ terminateWithStatus:() [1/2]

- (void) terminateWithStatus: (int)  status

Terminates the application with the specified status.

Parameters
statusThe status with which the application will terminate

◆ terminateWithStatus:() [2/2]

+ (void) terminateWithStatus: (int)  status

Terminates the application with the specified status.

Parameters
statusThe status with which the application will terminate

Property Documentation

◆ arguments

- (OFArray *) arguments
readnonatomicassign

The arguments passed to the application.

◆ environment

- (OFDictionary *) environment
readnonatomicassign

The environment of the application.

◆ programName

- (OFString *) programName
readnonatomicassign

The name of the program (argv[0]).


The documentation for this class was generated from the following files: