Re: [Q] inconsistent naming for Core Graphics and Foundation?
Re: [Q] inconsistent naming for Core Graphics and Foundation?
- Subject: Re: [Q] inconsistent naming for Core Graphics and Foundation?
- From: Ken Thomases <email@hidden>
- Date: Sun, 15 Mar 2009 03:21:57 -0500
On Mar 15, 2009, at 2:39 AM, JongAm Park wrote:
On Mar 15, 2009, at 12:04 AM, Andy Lee wrote:
On Mar 15, 2009, at 2:43 AM, JongAm Park wrote:
I'm just curious about the naming convention for Core Graphics and
Foundation.
For example, NSMakeRect and CGRectMake are similar but different
about where the "Rect" is in its method name.
What is even worse is NSPointInRect and CGRectContainsPoint.
So, if a person is used to the Foundation convention, it is not
intuitive to find proper method in Core Graphics.
Is there any reason they are named like that?
I noticed the differences too, and my guess was that it makes it
easier to find functions related to CGRects, by searching the API
for terms that contain "CGRect". I actually prefer it this way.
Whatever they are, it would be great if there is consistency or if
the document mentions those in "related functions or methods." part.
I think the division isn't Core Graphics vs. Foundation (or, more
generally, one framework vs. another). I think it's between legacy
and new APIs. It seems fairly clear to me that Apple has adopted a
convention that new APIs should be centered around a type, and that
names within such an API are to start with the name of the type.
However, large portions of Cocoa predate the adoption of this
convention, coming as they do from NeXTStep/OpenStep. Those parts
aren't going to be just gratuitously renamed to conform to the new
convention. That would be massively disruptive.
Unfortunately, there's just no way to generalize "one way to think
about all things". You have to accept things as they are and cope
with the fact that there isn't just one rule.
Regards,
Ken
_______________________________________________
Cocoa-dev mailing list (email@hidden)
Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden