KLSingleton

KLSingleton copied to clipboard

Description

This is a singleton class for iOS, Objective-C, Cocoa Touch, iPhone, iPad.

KLSingleton is:

0. Used in production
1. Subclassible (to the n-th degree)
2. ARC compatible
3. Safe with alloc and init
4. Loaded lazily
5. Thread-safe
6. Lock-free (uses +initialize, not @synchronize)
7. Macro-free
8. Swizzle-free
9. Simple

This implementation "loads lazily" (which is good). It does not "require explicit initialization" and it does not "lock to allocate". This implementation eliminates the iOS singleton boilerplate.

Use

1. Add the files to your project
2. Import the header using #import "KLSingleton.h"
3. Subclass the KLSingleton class in the following way:

@interface MYSubclass : KLSingleton

You may then retrieve the unique, ready-to-use instance of your class by calling any of the following methods:

[MYSubclass instance]
[MYSubclass sharedInstance] //alias
[MYSubclass singleton]      //alias
[[MYSubclass alloc] init]   //bad style, but safe to call any number of times

License

Released under ISC (similar to 2-clause BSD)