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]

Reply via email to