TweetFollow Us on Twitter

May 00 Bookshelf

Volume Number: 16 (2000)
Issue Number: 5
Column Tag: Programmer's Bookshelf

REALbasic: The Definitive Guide

By Paul E. Sevinç, Switzerland


REALbasic is an integrated development environment (IDE) from REAL Software, Inc. [3]. In the last couple of months, REALbasic was the topic of several MacTech articles written by Erick Tejkowski [4, 5, 6, 7]. For an overview of REALbasic, please refer to Erick's second article [5] or the REALbasic home page [3].

Written by Matt Neuburg and published by O'Reilly, REALbasic: The Definitive Guide [2] describes the higher edition of REALbasic version 2. But as targeting Windows is not covered, most of the text applies to the standard edition as well. Matt Neuburg is a past editor of MacTech, by the way, but this shall have no influence on my review.

The book is divided into three parts of about 210 pages each: Fundamentals, User Interface, and Reaching Out. Please note that unlike the first two parts, I haven't read the last part in its entirety (i.e., in number of pages, I have read about a third). Note further that I have never dealt with REALbasic prior to reading this book.


Chapter 1, The Workspace, and chapter 2, The Basic Language, introduce the REALbasic IDE and the REALbasic language, respectively. The explanations of the language constructs might be too terse for novices at programming. For everybody else, however, the concise writing allows for a quick transition to REALbasic without being boring or superficial. What irritated me a little at the beginning is that some names are capitalized differently in the code examples and in the main text. (REALbasic is case insensitive.) And Neuburg's definition of "side effect" is somewhat sloppy. Nevertheless, after two chapters only, I gained the impression that he is a pretty good teacher and writer.

Chapter 3, Objects, Classes, and Instances, and chapter 4, Subclasses, introduce object orientation in the context of REALbasic. These two chapters risk to frustrate novices at object-oriented programming (OOP): while a lot of concepts are explained in a very intuitive manner, non-trivial examples in which OOP unleashes its power are lacking. Beginners must be aware of this. After all, it is only natural that there are trade-offs when a book treats a language, a paradigm, an IDE, and a framework. Alas, Neuburg's treatment of interfaces may leave a wrong impression, namely that they are primarily a means of fixing class relationships or of supporting so-called binding. Yet every experienced Java programmer will confirm that single implementation inheritance with multiple interface inheritance allows for very clean and powerful designs.

Chapter 5, Datatypes, discusses elementary REALbasic data types, such as booleans, strings, and dates, as well as two classes that support low-level memory handling and threading, respectively. In the section on numbers, Neuburg uses the terms "binary", "octal", and "hexadecimal" without explaining them anywhere in the book. This (and what I said about novices in the preceding two paragraphs) leads me to the following question: Who is the target readership of the book in the first place? (On the cover it says "Macintosh programmers at all levels" and in the preface "this book does not teach you to program the Macintosh".) If it includes beginners, some sections of the book need to be elaborated. If not, some sections are not necessary (e.g., on what flow control is).

Chapter 6, Menus, shows how menus and menu items are created, how they can be enabled and disabled, how the application reacts to a menu item being chosen, etc. I particularly liked that it includes a section on dynamic menus with typical examples (Font menu and Windows menu). And chapter 7, The Architecture of an Application, gives some tips concerning REALbasic-based applications. It does not discuss architectural issues in general, however. (See, for instance, Buschmann et al. [1] for more on this topic.)

Chapter 8, Debugging and Building, concludes the first part. It explains how to read compile-error descriptions, REALbasic's exception handling, how to use the debugger, and the application build. After the first three pages in the section on exceptions, I was going to say that Neuburg chose a poor first example to illustrate them. Because it catches an exception caused by an error that can be fixed during development and that does not depend on the time & space in which the final application runs (e.g., on a computer with an unreliable hard drive). However, I then saw that four of REALbasic's five (or six) RuntimeException subclasses are about such errors, so that Neuburg isn't the one to be blamed. Nevertheless, he should have said more than just "Most of the time, you'll probably try to eliminate runtime errors from your program in advance" [2, p. 206].

User Interface

The first ten chapters of the second part cover graphical user interface (GUI) elements, the remaining two discuss the keyboard and the mouse. As is stated in the preface, the Human Interface Guidelines are not a topic of the book. Many different GUI elements are explained, such as windows, tab panels, sliders, etc. In addition to the default classes that REALbasic provides, Neuburg also presents subclasses and helper classes developed by him and others. Furthermore, a few advanced examples are also included. What I liked a lot is that Neuburg warns against bugs or limitations he encountered and tells the reader what to do about them.

To cut a long story short, this part is likely to contain valuable information about the GUI element the reader would like to employ. And in case the GUI element is not available or does not behave as desired, several ways to create a custom GUI element are shown as well.

Reaching Out

Chapter 21, Files, covers many file-related issues: creating and deleting files, navigating the file system, reading and writing the data or resource fork, preferences and temporary files, etc. The concept of file type and file creator is briefly explained, the difference between data fork and resource fork not really. Overall, however, the level of detail and the examples are very good. Particularly cool is that some of the example tasks - copying, for instance - are not only solved with REALbasic classes, but also with AppleScript scripts imported into the REALbasic project.

Chapter 29, Printing, is rather short, which-considering its importance-is a pity. Apparently that's because "Support for printing in REALbasic is rudimentary" [2, p. 555]. So, after a few tips, the reader is left to her own experimentation.

Chapter 31, Apple Events and AppleScript, first briefly introduces Apple events and AppleScript and then discusses Apple events and the REALbasic classes that support them in quite some detail. This chapter teaches how to send and receive events in order to make an application scriptable, and how to execute scripts from within an application.

To give you an idea of what other topics the third part includes, here are the titles of the remaining chapters (that I haven't read): Databases, Clipboard, Drag-and-Drop, Time, Sound, Movies, Game Animation, TCP/IP Communications, and Language Extensions.


Despite some shortcomings, Matt Neuburg's excellent writing and its broad range of topics make REALbasic: The Definitive Guide an easy-to-understand and very useful book for programmers entering the world of REALbasic.

In my opinion, the book is best suited for programmers with experience in OOP. Other programmers should do just fine, too, even though their perception of object orientation will probably be somewhat limited. For a complete novice, however, this book alone is not enough to get started.

What is clearly missing is an example application (e.g., a simple text editor) where different aspects such as menus, windows, files, printing, etc. could have been shown side by side. So feel free to develop such an application and to write about it in MacTech!


  1. F. Buschmann, R. Meunier, H. Rohnert, P. Sommerlad, and M. Stal. Pattern-Oriented Software Architecture: A System of Patterns. John Wiley & Sons, Chicester, 1996.
  2. M. Neuburg. REALbasic: The Definitive Guide. O'Reilly, Sebastopol, 1999.
  3. REAL Software. REALbasic. Home Page. Located at <>.
  4. E.J. Tejkowski. "REALbasic Plugin Programming". MacTech Magazine, Vol. 15, No. 10, pp. 12-21, October 1999.
  5. E.J. Tejkowski. "REALbasic". MacTech Magazine, Vol. 15, No. 11, pp. 46-57, November 1999.
  6. E.J. Tejkowski. "Speech and REALbasic". MacTech Magazine, Vol. 15, No. 12, pp. 46-49, December 1999.
  7. E.J. Tejkowski. "Networking with REALbasic". MacTech Magazine, Vol. 16, No. 2, pp. 13-19, February 2000

Paul recently earned a Dipl. El.-Ing. ETH degree, the Master's degree in electrical engineering from the Swiss Federal Institute of Technology Zurich (ETHZ). Now he hopes to finally find the time to finish Aho et al.'s Dragon Book. You can inquire on his progress at


Community Search:
MacTech Search:

Software Updates via MacUpdate

World of Tanks Generals guide - Tips and...
World of Tanks Generals is a brand new card game by the developer behind the World of Tanks shooter franchise. It plays like a cross between chess and your typical card game. You have to keep in consideration where you place your tanks on the board... | Read more »
TruckSimulation 16 guide: How to succeed...
Remember those strangely enjoyable truck missions in Grand Theft Auto V whereit was a disturbing amount of fun to deliver cargo? TruckSimulation 16 is reminiscent of that, and has you play the role of a truck driver who has to deliver various... | Read more »
The best GIF making apps
Animated GIFs have exploded in popularity recently which is likely thanks to a combination of Tumblr, our shorter attention spans, and the simple fact they’re a lot of fun. [Read more] | Read more »
The best remote desktop apps for iOS
We've been sifting through the App Store to find the best ways to do computer tasks on a tablet. That gave us a thought - what if we could just do computer tasks from our tablets? Here's a list of the best remote desktop apps to help you use your... | Read more »
Warhammer 40,000: Freeblade guide - How...
Warhammer 40,000: Freebladejust launched in the App Store and it lets you live your childhood dream of blowing up and slashing a bunch of enemies as a massive, hulking Space Marine. It's not easy being a Space Marine though - and particularly if... | Read more »
Gopogo guide - How to bounce like the be...
Nitrome just launched a new game and, as to be expected, it's a lot of addictive fun. It's called Gopogo, and it challenges you to hoparound a bunch of platforms, avoiding enemies and picking up shiny stuff. It's not easy though - just like the... | Read more »
Sago Mini Superhero (Education)
Sago Mini Superhero 1.0 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0 (iTunes) Description: KAPOW! Jack the rabbit bursts into the sky as the Sago Mini Superhero! Fly with Jack as he lifts impossible weights,... | Read more »
Star Wars: Galaxy of Heroes guide - How...
Star Wars: Galaxy of Heroes is all about collecting heroes, powering them up, and using them together to defeat your foes. It's pretty straightforward stuff for the most part, but increasing your characters' stats can be a bit confusing because it... | Read more »
The best cooking apps (just in time for...
It’s that time of year again, where you’ll be gathering around the dinner table with your family and a huge feast in front of you. [Read more] | Read more »
Square Rave guide - How to grab those te...
Square Rave is an awesome little music-oriented puzzle game that smacks of games like Lumines, but with its own unique sense of gameplay. To help wrap your head around the game, keep the following tips and tricks in mind. [Read more] | Read more »

Price Scanner via

13-inch 128GB MacBook Air now on sale for $79...
Best Buy has just lowered their price on the 2015 13″ 1.6GHz/128GB MacBook Air to $799.99 on their online store for Cyber Monday. Choose free shipping or free local store pickup (if available). Sale... Read more
Best Buy lowers 13-inch MacBook Pro prices, n...
Best Buy has lowered prices on select 13″ MacBook Pros this afternoon. Now save up to $200 off MSRP for Cyber Monday on the following models. Choose free shipping or free local store pickup (if... Read more
Cyber Monday: Apple MacBooks on sale for up t...
Apple resellers have MacBook Pros, MacBook Airs, and MacBooks on sale for up to $250 off MSRP for Cyber Monday 2015. The following is a roundup of the lowest prices available for new models from any... Read more
Cyber Monday: Apple Watch on sale for up to $...
B&H Photo has the Apple Watch on sale for Cyber Monday for $50-$100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - Apple Watch Sport: $50 off - Apple Watch: $50-$100 off B... Read more
Cyber Monday: 15% off Apple products, and sto...
Use code CYBER15 on Cyber Monday only to take 15% on Apple products at Target, and store-wide. Choose free shipping or free local store pickup (if available). Sale prices for online orders only, in-... Read more
iPad Air 2 And iPad mini Among Top Five Black...
Adobe has released its 2015 online shopping data for Black Friday and Thanksgiving Day. The five best selling electronic products on Black Friday were Samsung 4K TVs, Apple iPad Air 2, Microsoft Xbox... Read more
All-in-one PC Shipments Projected To Drop Ove...
Digitimes’ Aaron Lee and Joseph Tsai report that all-in-one (AIO) PC shipments may drop a double-digit percentage on-year in 2015 due to weaker-than-expected demand, although second-largest AIO make... Read more
Sprint Offers iPad Pro
Sprint now offers Apple’s new iPad Pro with Wi-Fi + Cellular, featuring a 12.9-inch Retina display with 5.6 million pixels. Customers can pick up iPad Pro at select Sprint retail locations. It can... Read more
Cyber Monday: Target offers 15% discount on A...
Target has discounted Apple Watches by 15% for Cyber Monday. Choose free shipping or free local store pickup (if available). Sale prices for online orders only, in-store prices may vary: - Apple... Read more
Sunday roundup of Holiday weekend Mac sales:...
Take up to $500 off MSRP on the price of a new Mac at B&H Photo today as part of their Black Friday/Holiday weekend sale. Shipping is free, and B&H charges NY tax only. These prices are... Read more

Jobs Board

Software Engineer, *Apple* Watch - Apple (U...
# Software Engineer, Apple Watch Job Number: 33362459 Santa Clara Valley, Califo ia, United States Posted: Jul. 28, 2015 Weekly Hours: 40.00 **Job Summary** Join the Read more
SW Engineer - *Apple* Music - Apple (United...
# SW Engineer - Apple Music Job Number: 40899104 San Francisco, Califo ia, United States Posted: Aug. 18, 2015 Weekly Hours: 40.00 **Job Summary** Join the Android Read more
Sr Software Engineer *Apple* Pay - Apple (U...
# Sr Software Engineer Apple Pay Job Number: 44003019 Santa Clara Valley, Califo ia, United States Posted: Nov. 13, 2015 Weekly Hours: 40.00 **Job Summary** Apple Read more
*Apple* Site Security Manager - Apple (Unite...
# Apple Site Security Manager Job Number: 42975010 Culver City, Califo ia, United States Posted: Oct. 2, 2015 Weekly Hours: 40.00 **Job Summary** The Apple Site Read more
iOS Wallet & *Apple* Pay Engineer - App...
# iOS Wallet & Apple Pay Engineer Job Number: 40586801 Santa Clara Valley, Califo ia, United States Posted: Nov. 16, 2015 Weekly Hours: 40.00 **Job Summary** The iOS Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.