73

I'm new to Objective C and I haven't been able to find out if there is the equivalent of a static constructor in the language, that is a static method in a class that will automatically be called before the first instance of such class is instantiated. Or do I need to call the Initialization code myself?

Thanks

3 Answers 3

132

The +initialize method is called automatically the first time a class is used, before any class methods are used or instances are created. You should never call +initialize yourself.

I also wanted to pass along a tidbit I learned that can bite you down the road: +initialize is inherited by subclasses, and is also called for each subclasses that doesn't implement an +initialize of their own. This can be especially problematic if you naively implement singleton initialization in +initialize. The solution is to check the type of the class variable like so:

+ (void) initialize {
  if (self == [MyParentClass class]) {
    // Once-only initializion
  }
  // Initialization for this class and any subclasses
}

All classes that descend from NSObject have both +class and -class methods that return the Class object. Since there is only one Class object for each class, we do want to test equality with the == operator. You can use this to filter what should happen only once ever, versus once for each distinct class in a hierarchy (which may not yet exist) below a given class.

On a tangential topic, it's worth learning about the following related methods, if you haven't already:


Edit: Check out this post by @bbum that explains more about +initialize: https://web.archive.org/web/20201108095221/http://www.friday.com/bbum/2009/09/06/iniailize-can-be-executed-multiple-times-load-not-so-much/

Also, Mike Ash wrote a nice detailed Friday Q&A about the +initialize and +load methods: https://www.mikeash.com/pyblog/friday-qa-2009-05-22-objective-c-class-loading-and-initialization.html

2
  • 5
    "if ([self class] == [MyParentClass class])" [self class] is redundant here. you can just say if (self == [MyParentClass class])
    – user102008
    Jul 22, 2011 at 22:47
  • 1
    Thank you! Your tidbit answered my question of why a particular static initializer was being invoked twice. Feb 1, 2013 at 1:32
51

There is the +initialize class method that will be called before a class is used.

2
  • Thank you, that's exactly what I was looking for, but I did searches to "static init", "static initializer", etc and didn't find it. Jun 14, 2009 at 5:26
  • 8
    In almost every case, where in Java you'd say "static," you say "class" in Objective-C.
    – Chuck
    Jun 14, 2009 at 18:21
10

A bit of an addendum to this topic:

There is another way to create a 'static constructor' in obj-c, using an __attribute directive:

// prototype
void myStaticInitMethod(void);

__attribute__((constructor))
void myStaticInitMethod()
{
    // code here will be called as soon as the binary is loaded into memory
    // before any other code has a chance to call +initialize.
    // useful for a situation where you have a struct that must be 
    // initialized before any calls are made to the class, 
    // as they would be used as parameters to the constructors.
    // e.g.
    myStructDef.myVariable1 = "some C string";
    myStructDef.myFlag1 = TRUE; 

    // so when the user calls the code [MyClass createClassFromStruct:myStructDef], 
    // myStructDef is not junk values.
}
14
  • 2
    +load will do the same thing and looks more in sync with the Objective-C paradigm Aug 15, 2012 at 17:06
  • @Grady Nope, I specifically list a situation in the post where +load is NOT equivalent. Aug 15, 2012 at 17:18
  • 1
    @RichardJ.RossIII: according to the documentation for +load, +load methods are called before __attribute__(constructor) functions
    – user102008
    Apr 14, 2013 at 9:01
  • 1
    @RichardJ.RossIII I don't understand what you are achieving since the code in the +load method is executed before the code in a function decorated with the constructor attribute. Can you please explain? Perhaps in an edit on your answer.
    – Sam
    Jun 23, 2014 at 14:29
  • 1
    @Sam did you understand, what is RichardJ.Rosslll talking about ? I'd like to have a real-life example...
    – denis631
    May 13, 2015 at 14:16

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.