Need explanation on @property/@synthesize in iOS

Question

Not a complete noob I am quite new to iOS programming and to Ojbective-C. I mainly come from a background of C (DSP, Microcontrollers), Delphi XE2/Pascal , Visual Basic and Java (desktop and Android apps).

I mainly learned Cocoa with the book "Beginning iOS 5 Development", from Apress.

Recently I watched videos of the WWDC 2012 and went through some of their sample code, and I must say that I am confused of what is the proper way of writing my apps and more specifically with the @property/@synthesize words.

In the book most (not to say all) of the sample code uses to define a property as for example

ViewController.h @property (strong, nonatomic) NSMutableArray *list;  ViewController.m @synthesize list; 

then all the code access synthesize list with

self.list 

or even simply

list 

Now in every WWDC code sample I read I see that programmers define a property but then, in the .m file they do things like

@synthesize list = _list; 

and access sometimes

self.list 

or

_list 

I am confused. What is the correct practice ? As Apple programmers all use underscore I think I should do it that way but why the book did not ? Is there a difference between list and _list ? And more over, as I am in the same object why sometime use self.list and sometimes list/_list.

Sometimes they don't use @synthesize, I assume it's when they want to re-write their own accessors and mutators (which is never my case up to now).

I have read here and there on the web but nothing was clear enough to set my mind right, so I count on StackOverflow to bring light here.

Last but not least I prefer and answer based on current iOS 6 best practice/programming technique. Useless to tell me how to do it correctly in older iOS.

Answer 1

There is no correct way. There is only your preferred style.

The lastest compilers do an implicit synthesise on the property declaration.

@synthesize list = _list; .

Nothing is ever written in your code. It just happens.

However that doesnt stop you doing this explicitly.

@synthesize list = somethingelse;

So when you ask for a pointer to list via the accessor (self.list) you will get a pointer to somethingelse

In most cases NSMutableArray *thing = self.list is equivalent to NSMutableArray *thing = somethingelse

And just because Apple uses a style doesn't mean that you have to do it. Each company usually has their own coding style.

The main problem with using @synthesize list; is that it poses the risk that you can write either

self.list = thing or list = thing .

The former uses the sythesised setList: accessor while the latter doesn't and put the risk of related bugs in your code , though its not as bad with ARC as you dont get leaks happening for strong properties.

What ever style you use, keep it consistent and be aware of the effects of using an ivar directly list = thing as compared to using its accessor self.list = thing