TweetFollow Us on Twitter

Digging in to Objective-C

Volume Number: 19 (2003)
Issue Number: 2
Column Tag: Getting Started

Digging in to Objective-C

by Dave Mark

In this month's column, we're going to start our foray into Objective-C. Before we do that, however, let's make sure we're on the same page, tools-wise.

Got the Latest Tools?

If you haven't already, login to http://developer.apple.com/ and download the December 2002 Mac OS X Developer Tools. Note that the download is 301.2 MB so maybe let this one run during your lunch break. Note that the December 2002 Tools will only run on 10.2 or later. If you need to run on an earlier OS, stick with the April 2002 Tools.

Once your download is complete, you'll have a very large file named Dec2002DevToolsCD.dmg. Double-click this. The disk image that mounts will contain a file named Developer.mpkg. This master package will install all the packages in the Packages folder. No need to install these separately.

The install will take a while. Be patient. There's a lot of stuff here. Here's a list of the packages that will be installed as part of this process:

    - Developer Tools (DevTools.pkg)

    - Mac OS X SDK (DevSDK.pkg)

    - Developer Documentation (DevDocumentation.pkg)

    - Developer Examples (DevExamples.pkg)

    - SDK pieces for UNIX development (BSDSDK.pkg)

    - A package with extra pieces needed for Project Builder-emacs integration (Dec2002DevToolsExtras.pkg)

If your setup was the same as mine, you were running Project Builder 2.0.1 and are now running Project Builder 2.1. This is from the Project Builder 2.1 section in the file What's New.pdf:

    - Support for external editors:

    * You can use arbitrary editors for different file types.

    * Project Builder will show you build errors in your external editor when you use BBEdit or emacs.

    - Build system features:

    * Project Builder will now do multiple compiles at the same time on machines with more than one processor.

    * Project Builder's header dependency analysis is improved.

    * Project Builder now links executables in a more optimal manner.

    * You can now set compile flags on a per-file basis.

    * Assembler flags are now separate from flags to the compiler.

    - Interface to customize key bindings.

    - Better CVS integration.

    - The CodeWarrior project importer has been vastly improved.

    - Miscellaneous interface improvements:

    * You can now sort files, targets, and build phase objects in a project.

    * You can display line numbers on the same line as your source.

    * The breakpoint gutter has been improved.

    - JavaDoc documentation is now indexed so that it can be used with Project Builder's integrated documentation.

    - Improved text encoding support.

    - There is support for dynamic C++ types in the debugger.

In addition, here's the non-Project Builder specific stuff:

    * gcc3.1 has several bug fixes. In addition:

    - an optimization has been made to speed up searching for header files. If your command lines have a lot of -I directives to add directories to the compiler's search path, this optimization should help your compile time.

    - The HTML documentation for the compiler is missing from the release. You can find it on the web at:

    http://developer.apple.com/techpubs/macosx/DeveloperTools/gcc3/gcc/index.html

    http://developer.apple.com/techpubs/macosx/DeveloperTools/gcc3/cpp/index.html

    * AppleScript Studio 1.2.1 adds enhanced dictionary support. The sample projects will now run on both Mac OS X 10.1 systems as well as Mac OS X 10.2. Please read the AppleScript Studio release notes for more information.

    * CHUD 2.5.1 is now on the CD. CHUD is a set of tools for low-level system debugging and profiling. To install, open the disk image, and follow the instructions.

    * !AppleScript Editor 2.0 Beta is now available in the Pre-release Software folder. Please read the "About These Packages.rtf" file in the Pre-release Software folder for more details. Note that this package requires Mac OS X 10.2.3 or higher.

    * The jikes Java compiler has been updated to version 1.17.

    * PackageMaker has some new features:

    - Drag-and-drop functionality in the list editor.

    - Inline attribute editing.

    - Progress sheet for status during package creation.

    - Package completion dialog.

    * Sherlock SDK - There is now an SDK available to develop your own Sherlock channels. See

    /Developer/Examples/Sherlock for sample channels and the online documentation for more information.

    * DiscRecording SDK - There are now sample projects demonstrating the DiscRecording framework. Please see: /Developer/Examples/DiscRecording/About Disc Recording Examples.rtf for more information.

    * CoreAudio SDK - There are more examples in /Developer/Examples/CoreAudio. Please see /Developer/Examples/CoreAudio/ReadMe.rtf for more information.

    * FireWire SDK - There is now a complete SDK for developing for FireWire devices. Please see

    /Developer/Examples/IOKit/firewire for the samples.

    * ForceFeedback SDK - The header files necessary to take advantage of Mac OS X 10.2.3's ForceFeedback framework have been added.

    * AvailabilityMacros - You can now control which OS version you want to target your application for using the AvailabilityMacros. Please see

    /Developer/Documentation/ReleaseNotes/AvailabilityMacros.h for more details.

    * New and updated documentation. Lots of new documentation content is included in this release. Please check the various "what's new" portions of the documentation for more information.

When you launch Project Builder 2.1 for the first time, the release notes window appears. You can bring this window up again at any time by selecting Show Release Notes from Project Builder's Help menu.

On to Objective-C...

OK. Now that we're all using the same tools, let's dig into our main course. Objective-C is based on the C programming language. In effect, it is C with objects. Though there are many differences between Objective-C and C++, the main difference lies in the dynamic nature of Objective-C.

C++ requires static dispatch, static typing, and static loading. Objective-C offers dynamic dispatch, dynamic typing, and dynamic loading. In a nutshell, static dispatch means the decision of which object receives which message happens at compile-time, while dynamic dispatch means the decision is delayed until run-time.

Same thing with typing and loading. When the type of the message receiver can be determined at run-time, that's dynamic typing. When code can be linked and executed at run-time as opposed to at compile-time, that's dynamic loading.

To me, all three of these concepts are very tightly intertwined. A static approach offers the safety of forcing a lot of problems to the surface at compile-time. Don't be lulled into a false sense of security, however. Just because your code compiles doesn't mean your code isn't riddled with errors. It just means that your code conforms, at a basic level, to the language syntax enforced by the compiler. But static typing, for example, clearly offers a certain level of safety not afforded by dynamic typing.

The dynamic approach jettisons the static safety net in exchange for incredible flexibility and freedom. Dynamic loading means you can deliver a new suite of objects to your customer over the net, and have the code installed, all while the existing app is still up and running. Imagine the possibilities. You could fix a bug on a mission-critical program without having to shut it down. If you knew the protocol, you could even patch someone else's program, replacing their inferior object with one of your own design.

To be fair to C++, there is a certain element of risk in a completely dynamic approach. But with this risk comes great potential reward. Whichever side of the dynamic/static argument you come down on, there is no downside to learning and understanding Objective-C. If you understand the benefits of Objective-C, you can make an informed choice between it and C++. And the cool thing is, with Objective-C, you can still use static typing when you choose to (to make an element of your code clearer to others, for example). With Objective-C, you get the best of both worlds.

If all this seems a little vague, not to worry. Over time, as we dig into more and more code, these concepts will fall into place. Let's take a look at an example.

Employee: The C++ Version

To start things off, here's a relatively simple C++ program (lifted and slightly modified from Learn C++ on the Macintosh, with permission from the author!) that we'll translate into Objective-C. We're going to define a class named Employee, then create and destroy a couple of Employee instances.

Want to follow along in Project Builder? Create a new project, and select "C++ Tool" from the "Tool" category when prompted for the type of project to build. Now select New File from the File menu and choose "C++ Class" from the "Carbon" category. You'll call the new class "Employee". Project Builder will create two new files (assuming you checked the "Also create Employee.h" checkbox) and add them to your project. All you need to do is replace the contents of Employee.h, Employee.cpp, and main.cpp with the code below.

    Got a net connection? Rather download the code than type it in? We're working on adding the code downloads to the MacTech web site. If that is not up and running by the time you read this, head over to http://www.spiderworks.com and download the code from there. I'll put both the C++ and Objective-C versions up for your downloading pleasure.

Here's Employee.h:

class Employee
{
//         Data members...
   private:
      char   employeeName[ 20 ];
      long   employeeID;
      float   employeeSalary;
//         Member functions...
   public:
            Employee( char *name, long id, float salary );
            ~Employee( void );
      void   PrintEmployee( void );
};

Here's Employee.cpp:

#include <iostream>
#include "employee.h"
Employee::Employee( char *name, long id, float salary )
{
    strcpy( this->employeeName, name );
    this->employeeID = id;
    this->employeeSalary = salary;
    
    std::cout << "Creating employee #"
                           << employeeID << "\n";
}
Employee::~Employee( void )
{
    std::cout << "Deleting employee #"
                           << employeeID << "\n";
}
void   Employee::PrintEmployee( void )
{
    std::cout << "-----\n";
    std::cout << "Name:   " << employeeName << "\n";
    std::cout << "ID:     " << employeeID << "\n";
    std::cout << "Salary: " << employeeSalary << "\n";
    std::cout << "-----\n";
}

Finally, here's main.cpp:

#include <iostream>
#include "employee.h"
int main (int argc, const char * argv[])
{
    Employee   employee1( "Frank Zappa", 1, 200.0 );
    Employee   employee2( "Donald Fagen", 2, 300.0 );
    employee1.PrintEmployee();
    employee2.PrintEmployee();
}

Once all the code is typed in, give it a run and compare your results to those shown in Figure 1. If you compare the results with the code in main.cpp, you'll see that the first two lines are produced as the two Employee objects are created, the next two chunks (5 lines each) are produced by the two calls to PrintEmployee(), and the two "Deleting" lines are produced when the program exits and the objects are destroyed.


Figure 1. The C++ version of Employee in action.

The Employee object is fairly straight-forward. Looking at the code in Employee.cpp, you'll see that the constructor uses its arguments to initialize the data members of the Employee object, then uses cout to send a message letting us know the object is being created. The destructor also uses cout to let us know its object is being destroyed. And PrintEmployee() uses cout to print some useful info as well.

Pretty straight-forward, right? Now let's create an Objective-C program to do the same thing.

Employee: The Objective-C Version

In Project Builder, select New Project... from the File menu. This time, select "Foundation Tool" from the Tool category. Now select New File... from the File menu and choose Objective-C Class from the Cocoa category. Name the new file Employee.m and be sure the "Also create Employee.h" checkbox is checked.

As you did with your C++ project, now you'll replace the contents of Employee.h, Employee.m, and main.m with the code below. Here's Employee.h:

#import <Foundation/Foundation.h>
@interface Employee : NSObject {
    @private
        char      employeeName[20];
        long      employeeID;
        float      employeeSalary;
}
- (id)initWithName:(char *)name andID:(long)id
    andSalary:(float)salary;
- (void)PrintEmployee;
- (void)dealloc;
@end

Here's Employee.m:

#import "Employee.h"
@implementation Employee
    - (id)initWithName:(char *)name andID:(long)id
                            andSalary:(float)salary {
        strcpy( employeeName, name );
        employeeID = id;
        employeeSalary = salary;
        
        printf( "Creating employee #%ld\n", employeeID );
        
        return self;
    }
    
    - (void)PrintEmployee {
        printf( "----\n" );
        printf( "Name:   %s\n", employeeName );
        printf( "ID:     %ld\n", employeeID );
        printf( "Salary: %5.2f\n", employeeSalary );
        printf( "----\n" );
    }
    - (void)dealloc {
        
        printf( "Deleting employee #%ld\n", employeeID );
        
        [super dealloc];
    }
@end

and here's main.m:

#import <Foundation/Foundation.h>
#import "Employee.h"
int main (int argc, const char * argv[]) {
    NSAutoreleasePool * pool =
                        [[NSAutoreleasePool alloc] init];
    Employee*   employee1 = [[Employee alloc] initWithName:"Frank Zappa" andID:1 andSalary:200];
    Employee*   employee2 = [[Employee alloc] initWithName:"Donald Fagen" andID:2 andSalary:300];
    [employee1 PrintEmployee];
    [employee2 PrintEmployee];
    
    [employee1 release];
    [employee2 release];
    
    [pool release];
    return 0;
}

As you did before, run the project. This time, compare your results with Figure 2. Look familiar? The Salary field looks a bit different but, other than that, the results are identical.


Figure 2. The results of the Objective C version of Employee.

Till Next Month...

Take some time and look at the Objective-C and C++ code side-by-side. You should be able to tell a lot about the Objective-C code just from this context. In next month's column, we're going to dissect the Objective-C code, line-by-line. Till then, here's some food for thought:

In C++ you call a member function. In Objective-C you send a message to a receiver. For example, in C++ you might use an object pointer to say:

myObj->changeValue;

In Objective-C you'd say:

[myObj changeValue];

Objective-C classes are, like their C++ counterparts, broken into an interface (the ".h" file) and an implementation (the ".m" file). Instance methods start with a "-" character in the interface, class methods start with a "+".The type "id" is Objective C's generic object pointer type. You'll see it a lot.

(id)myFunc; declares a function named myFunc that returns an id pointer.

(id)getP:(int)p; declares a function named getP: that takes a parameter p of type int. The colon at the end of the function name indicates that the function takes a parameter.

(id)getP:(int)p andQ:(long)q declares a function named getP:andQ: taking two params - an int named p and a long named q.

Look through the code, think about what's happening, see you back here next month...


Dave Mark is very old. He's been hanging around with Apple since before there was electricity and has written a number of books on Macintosh development, including Learn C on the Macintosh, Learn C++ on the Macintosh, and The Macintosh Programming Primer series. Check out Dave's web site at http://www.spiderworks.com

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

BusyContacts 1.6.4 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
Steam 4.0 - Multiplayer and communicatio...
Steam is a digital distribution, digital rights management, multiplayer and communications platform developed by Valve Corporation. It is used to distribute a large number of games and related media... Read more
OmniGraffle Pro 7.19.3 - Create diagrams...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more
OmniGraffle 7.19.3 - Create diagrams, fl...
OmniGraffle helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use Graffle to... Read more
Hopper Disassembler 5.3.3- - Binary disa...
Hopper Disassembler is a binary disassembler, decompiler, and debugger for 32- and 64-bit executables. It will let you disassemble any binary you want, and provide you all the information about its... Read more
calibre 5.35.0 - Complete e-book library...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital librarian... Read more
Sound Studio 4.10.0 - Robust audio recor...
Sound Studio lets you easily record and professionally edit audio on your Mac. Easily rip vinyls and digitize cassette tapes, or record lectures and voice memos. Prepare for live shows with live... Read more
Sparkle Pro 4.0 - Visual website creator...
Sparkle Pro will change your mind if you thought building websites wasn't for you. Sparkle is the intuitive site builder that lets you create sites for your online portfolio, team or band pages, or... Read more
Dropbox 140.4.1951 - Cloud backup and sy...
Dropbox for Mac is a file hosting service that provides cloud storage, file synchronization, personal cloud, and client software. It is a modern workspace that allows you to get to all of your files... Read more
FotoMagico 6.0.5 - Powerful slideshow cr...
FotoMagico lets you create professional slideshows from your photos and music with just a few, simple mouse clicks. It sports a very clean and intuitive yet powerful user interface. High image... Read more

Latest Forum Discussions

See All

Best iPhone Game Updates: ‘Garena Free F...
Hello everyone, and welcome to the week! It’s time once again for our look back at the noteworthy updates of the last seven days. I got busted last week for not including the obligatory free-to-play matching puzzle game update of the week, and my... | Read more »
‘Horizon Chase’ China Spirit DLC Release...
Following the release of the excellent reveal of the Horizon Chase Senna Forever expansion, the game will be getting a new DLC on mobile platforms today. Today, the Horizon Chase China Spirit DLC pack will release on iOS and Android bringing in 9... | Read more »
‘PUZZLED’ from SNK and Hamster Is Out No...
Following ZED BLADE ACA NeoGeo earlier this month, SNK has brought over another game in the ACA NeoGeo series to both iOS and Android in the form of PUZZLED. SNK and Hamster originally brought the series to mobile with Samurai Shodown IV, Alpha... | Read more »
A House Full of Covid – The TouchArcade...
It’s been a rough week as both of our young children tested positive for Covid, and since recording this early on Friday my wife has tested positive now too. Thankfully the kids seemed to recover fairly quickly and are mostly back to normal, and I... | Read more »
TouchArcade Game of the Week: ‘Krispee S...
Krispee Street is a new hidden object game from Frosty Pop that is based on their popular and almost painfully sweet webcomic Krispee. This is one of the latest titles to be added to the Netflix Games catalog, which means you’ll need to log into... | Read more »
SwitchArcade Round-Up: ‘Escape Lala’, ‘B...
Hello gentle readers, and welcome to the SwitchArcade Round-Up for January 21st, 2022. In today’s article, we’ve got a lot of new releases. A lot. There were eight on the schedule when I went to bed last night. There were twenty-four when I woke up... | Read more »
Beta Testers Needed for Huge Version 2.0...
Ya’ll remember Dungeon Raid, right? The phenomenal matching RPG hybrid that launched on mobile more than a decade ago, but was more or less abandoned by its developer only to die a slow death on the App Store before the 32-bit Appocalypse finally... | Read more »
‘Ark Legends’ Gives Players a Chance to...
It’s Airpods and Amazon gift cards galore as Melting Games opens pre-registration for Ark Legends. The upcoming mobile RPG is giving away tons of in-game goodies such as gold, energy, iron core, hero summon chest and rare iron core to players who... | Read more »
‘Nickelodeon Extreme Tennis’ Out Now on...
Nickelodeon Extreme Tennis () from Old Skull Games and Nickelodeon is this week’s new Apple Arcade release. Nickelodeon Extreme Tennis features characters from old and new Nickelodeon shows including SpongeBob, TMNT, and many more. The tennis game... | Read more »
SwitchArcade Round-Up: ‘RPGolf Legends’,...
Hello gentle readers, and welcome to the SwitchArcade Round-Up for January 20th, 2022. In today’s article, we’ve got a massive amount of new releases to check out. We’ve got summaries of all of them, from heaven to hell. We also have the lists of... | Read more »

Price Scanner via MacPrices.net

Verizon’s 2022 iPad promo: $100-$310 off any...
Verizon has cellular-capable iPads on sale for $100-$310 off MSRP when purchased with an Unlimited service plan. Sale price is applied to your account monthly over a 24 or 30 month period, depending... Read more
Sunday Sale: Apple AirPods are on sale for up...
Amazon has Apple AirPods on sale for $10-$100 off MSRP today, depending on the model. All are in stock today with free delivery: – AirPods Max headphones (Blue): $449 $100 off MSRP – AirPods Max... Read more
These Apple resellers are offering 13″ M1 Mac...
Apple resellers are offering discounts on 13″ MacBook Pros with M1 Apple Silicon processors ranging up to $150 off MSRP. Here’s where to get one today: (1): Apple’s 13″ MacBook Pros with M1 Apple... Read more
Amazon lowers prices on select 13″ M1 MacBook...
Amazon has select Apple 13″ M1 MacBook Airs on sale for $150 off MSRP this weekend, starting at only $849. Their prices are the lowest available for new MacBook Airs today. Stock may come and go, so... Read more
Apple has 13″ M1 MacBook Airs back in stock s...
Apple has restocked a full line of 13″ M1 MacBook Airs, Certified Refurbished, starting at only $849 and up to $190 off original MSRP. These are the cheapest M1-powered MacBooks for sale today at... Read more
In stock and on sale! 16″ 10-Core M1 Pro MacB...
Amazon has new 16″ 10-Core/512GB M1 Pro MacBook Pros in stock today and on sale for $50 off MSRP including free shipping. Their prices are the lowest available for new M1 Pro 16″ MacBook Pro from any... Read more
Deal Alert!: 14″ M1 Pro with 10-Core CPU in s...
Amazon has the new 14″ M1 Pro MacBook Pro with a 10-Core CPU and 16-Core GPU in stock today and on sale for $2299.99 including free shipping. Their price is $200 off Apple’s standard MSRP, and it’s... Read more
Apple has 24-inch M1 iMacs (8-Core CPU/8-Core...
Apple has restocked a wide array of 24-inch M1 iMacs with 8-Core CPUs and 8-Core GPUs in their Certified Refurbished store. Models are available starting at only $1269 and range up to $260 off... Read more
Select 24″ M1 iMacs are on sale for $100 off...
Sales of Apple’s new 24″ M1 iMacs have been rare since its introduction, perhaps due to global supply issues. However, B&H is offering a $100 discount on select 24″ iMacs, and they’re in stock... Read more
M1 Mac minis are back in stock today at Apple...
Apple has M1-powered Mac minis available in their Certified Refurbished section starting at only $589 and up to $140 off MSRP. Each mini comes with Apple’s one-year warranty, and shipping is free: –... Read more

Jobs Board

Registered Nurse (RN) Employee Health PSJH -...
…is calling for a Registered Nurse (RN) Employee Health PSJH to our location in Apple Valley, CA.** We are seeking a Registered Nurse (RN) Employee Health PSJH to be Read more
Systems Administrator - Pearson (United State...
…and troubleshoot Windows operating systems (workstation and server), laptop computers, Apple iPads, Chromebooks and printers** + **Administer and troubleshoot all Read more
IT Assistant Level 1- IT Desktop Support Anal...
…providing tier-1 or better IT help desk support in a large Windows and Apple environment * Experience using IT Service Desk Management Software * Knowledge of IT Read more
Human Resources Business Partner PSJH - Provi...
…**is calling a** **Human Resources Business Partner, PSJH** **to our location in Apple Valley, CA.** **Applicants that meet qualifications will receive a text with Read more
Manager Community Health Investment Programs...
…is calling a Manager Community Health Investment Programs PSJH to our location in Apple Valley, CA.** **Qualified candidates will be invited to do a self-paced video Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.