Using static keyword in objective-c when defining a cached variable

Static variables retain their assigned values over repeated calls to the function. They're basically like global values that are only "visible" to that function.

The initializer statement is only executed once however.

This code initializes dateFormatter to nil the first time the function is used. On every subsequent call to the function a check is made against value of dateFormatter. If it's not set (which will only be true the first time) a a new dateFormatter is created. If it is set then the static dateFormatter variable will be used instead.

It's worth becoming familiar with static variables. They can be very convenient but have downsides too (in this example it's impossible to release the dateFormatter object for example).

Just a tip: Sometimes it can be educational to place a breakpoint in the code and have a look to see what's going on. As the complexity of your programs increase this will become an invaluable skill.

"static" functionally means "don't evaluate the stuff on the right side of the equals sign every time through, use its previous value instead" in this case.

Use this great power with great responsibility: you run the risk of using a whole ton of memory, since these are objects that never go away. It's rarely appropriate except for in cases like this one with NSDateFormatter.

For reference purposes, this is how I am using the static for my date formatter for using in a table view controller.

+ (NSDateFormatter *) relativeDateFormatter{     static NSDateFormatter *dateFormatter;     static dispatch_once_t onceToken;     dispatch_once(&onceToken, ^{         //NSLog(@"Created");         dateFormatter = [[NSDateFormatter alloc] init];         [dateFormatter setTimeStyle:NSDateFormatterNoStyle];         [dateFormatter setDateStyle:NSDateFormatterMediumStyle];         NSLocale *locale = [NSLocale currentLocale];         [dateFormatter setLocale:locale];         [dateFormatter setDoesRelativeDateFormatting:YES];     });     return dateFormatter;}