You're not having a problem reading the docs. You're having a problem with your basic understanding of Objective-C. There's nothing to "convert" and what you're reading is "actual code". I'd recommend taking a step back and doing some reading before you go any further.
Perhaps here: http://developer.apple.com/documentation/Cocoa/Conceptual/ObjectiveC/ObjC.pdf and here: http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/ObjCTutorial.pdf - Jason On Tue, Jul 15, 2008 at 4:19 PM, Phil Faber <[EMAIL PROTECTED]> wrote: > Hi all. > > As a relative newbie I'm eager to learn but my biggest stumbling block is > understanding that the XCode's Help>Documentation actually means; can > someone guide me? > > For example, if I want to put a substring of a larger string (eg. "ertyu" > from "qwertyuiop") into a second field, I search the documentation and come > across a thing under NSString called getCharacters:range. I assume this > will do the job as it seems to get characters from a string as specified by > a range; I then look at the usage information which reads: > > - (void)getCharacters:(unichar *)buffer range:(NSRange)aRange > > My challenge is that I don't know what this means or how to convert this > into actual code. So I have to keep guessing which surely can't be the > preferred way to learn! > > > So I try: > > [newField setStringValue:[NSString getCharacters:buffer range:2,3]]; > > ..and am told: > > error: 'buffer' undeclared > warning: 'NSString' may not respond to '+getCharacters:range:' > > > ..so I try: > > [newField setStringValue:[NSString getCharacters:2,3]]; > > ..and am told: > > warning: 'NSString' may not respond to '+getCharacters:' > > > .. so I try: > > [newField setStringValue:[NSString getCharacters:buffer range:2-3]]; > > ..and am told: > > error: 'buffer' undeclared > warning: 'NSString' may not respond to '+getCharacters:range:' > > > ..and so on. > > I'm a newbie; I'm still learning how to do simply stuff like add two > numbers together, display 'hello world' and so on! What I could really do > with is the documentation giving examples. > > Can anyone explain how I can 'decode' the usage information shown in the > documentation into real code? Not just for this example, but in general. > > If I can't understand this, I fear I'll spend most of my time asking others > how to achieve the most basic of tasks. > > Thanks. > > Phil > _______________________________________________ > > Cocoa-dev mailing list (Cocoa-dev@lists.apple.com) > > 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: > http://lists.apple.com/mailman/options/cocoa-dev/jsallis%40gmail.com > > This email sent to [EMAIL PROTECTED] > _______________________________________________ Cocoa-dev mailing list (Cocoa-dev@lists.apple.com) 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: http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com This email sent to [EMAIL PROTECTED]