TweetFollow Us on Twitter

Debugging C
Volume Number:5
Issue Number:2
Column Tag:Programmer's Forum

Lightspeed C Debugging

By Gary Odom, Plano, TX

Gary Odom is a software developer for Altsys Corporation (Freehand, Fontographer, Fontastic Plus), and a long time friend of MacTutor. Gary kills his spare time working on an AI project for the Japanese market.

Overview

Think’s LightspeedC is a C development system produced by Symantec Corporation. THINK C’s claims to fame have been its fully integrated environment, blazing speed, and ease of use. A new version, 3.0, came out the beginning of August, sporting a source-level debugger. This article is a review of THINK C 3.0, with special emphasis on the new debugger. First, some overview for those not familiar with the product.

All development in THINK C occurs in one application. The editor, compiler and linker are all integrated under one menu bar. THINK C uses the concept of a project for building an application or other code resource. All source files and libraries used to build an application are listed in a project window (Figure 1, bullseye Π). You can double-click on a file name in the project window to open that file. All object code is kept in the project file.

THINK C allows you to easily build most any kind of code, from applications to desk accessories (and other drivers) and FKeys (and other code resources). Segmentation of a large project is simple: you simply set a file or library into a segment. No separate link command file is needed.

You can write inline assembly with THINK C. Particularly convenient is the ability to use C identifiers directly, including structure members.

You can use, and even require, function prototypes in THINK C 3.0. Function prototypes, a new ANSI C feature, provide function type checking previously lacking in C (unlike Pascal, where such type checking is an integral aspect). Checking pointer types is also optional.

New with 3.0 is the ability to precompile headers, to speed inclusion of header (.h) files. There is a default file, MacHeaders, that has the common Macintosh includes. You can edit that and recompile it to include a different set of Mac includes, or use any precompiled header file you construct (in lieu of MacHeaders). There is a limitation that only one precompiled header can be included in source file, though you can get around that (in a way) by including a precompiled header file in a self-constructed header file to be precompiled (nested precompiled headers).

You can interactively compile and run a project to test execution. Because THINK C uses an incremental linker, link time is negligible. (When you finally link/create an application, though, you must wait for the object code and resources to be copied into the application file.)

I’ve read several articles that recommend THINK C for individual projects, but MPW for group projects. I don’t understand why. It is very easy to merge a group project in THINK C, a reason often cited for preferring MPW. New code can be added to a project as libraries, completely separate projects (which behave like libraries), or individual files.

I’ve seen tables on the code generation quality of THINK C versus other environments. The intention of this article is not to provide yet another set of benchmarks. Suffice to say that THINK C produces executable applications with code that is both compact and swift, relatively speaking (MPW C being first cousin). Symantec is always working on ways to improve compilation. For me, it’s comforting to know that a product is receiving constant upgrade attention by a dedicated team.

Evaluation

There are a lot of things to like about THINK C, with convenience and speed being at the top of the list. The user interface and seamless integration are what make THINK C so easy to use. While THINK C has a plethora of features, there are a few it doesn’t have that I’d like.

QUED/M by Paragon Concepts is a macro editor for the Mac that is a yardstick of excellence for text editors to be measured against. By comparison, the editor included in THINK C is convenient and fast, but lacks some desirable features. What is particularly good about the THINK C editor (besides being fully integrated into the environment) are the search and replace functions (including Grep), and convenient window management (command keys 0-9 bring the project window and up to nine text file windows to the front). Another good feature is that you can Option double-click a variable or function and go straight to the variable or function declaration (though you can’t get back using a similar method).

Some features noticeably lacking in the THINK C editor are split screen windows, a change case capability, and a gremlin zapper to rid the text of unneeded spaces and option key characters that can cause the compiler to mysteriously barf. I use the THINK C editor most of the time, as it is integrated into the environment. But for industrial strength text sessions, I find myself in the MultiFinder stagecoach with QUED/M riding shotgun.

There is an info window, which shows object code sizes for files, segments and the project. I consider it useless. But it would be nice to know the number of lines of code in the source file and project, which isn’t shown.

There is a default teletype (text console) window and default menus that spontaneously arise when you use printf() or other standard I/O. This is useful for testing code and not much else. I like the extensive console package provided by Consulair Mac C, where any window can be set as the console (without obligatory menus if appropriate), which means printf() can be used with any window, saving the tedium of formatting text using DrawString() and pen movement routines from Quickdraw.

MPW C is going to be extended to include C++, an object-oriented extension of C. While a degree of object-oriented programming can be accomplished via sheer technique (without language extensions), C++ provides the full capability of object orientation, and is the next evolutionary step in the C language. Symantec is considering how best to implement C++ while not making it an interference in terms of user convenience and quality code generation. Don’t look for THINK C++ Real Soon Now, but, according to Symantec, it’s probably in the pipeline for the next major release.

Symantec is receptive to new features for THINK C. They recently sent a survey to get some feedback. Contact Symantec with your suggestions. Now is a particularly good time, while they are catching their breath from the latest release.

Debugging

In previous versions of THINK C, running a project interactively meant having to use TMON or MacsBug to sift through the wreckage of a crash. No more. (Though you can still use TMON or Macsbug via the “Monitor” menu item in the Think C Debugger.) THINK C 3.0 has a new source-level debugger. There is a caveat, however. You must have at least 2 Mb of memory to use the debugger, which runs under MultiFinder. (THINK C takes a default 700 Kb, the Debugger 200Kb, and 384Kb for your application.)

To use the debugger, you must compile source with the “Use Debugger” menu option enabled. A bug shows in the project window to indicate debugging is enabled (Figure 1, bullseye Π). Diamonds by the files indicate which source can be stepped into to trace execution. Libraries (such as MacTraps) cannot wear a diamond, as the source is not available.

When you run with the debugger enabled, a solid arrow indicates the current line of execution (Figure 1, bullseye.c). The data window to the right is for examining variables.

Clicking on a hollow diamond on the left of the source window sets a breakpoint, making the diamond solid. Likewise, you click a solid diamond to remove a breakpoint. You can easily set temporary and conditional breakpoints.

The buttons at the top of the source window (bullseye.c in Figure 1) control execution. “Go” runs the program until a breakpoint is encountered. “Step” executes the current statement, stopping at the next statement. “Trace” is similar to “Step”, but goes into a called routine to the next executable line (unlike step, which executes the called function without going into it). “In” steps into a function. “Out” finishes executing the routine it’s in and pops out. “Stop” halts execution.

You can look at the current value of variables in the data window. The huge check is an enter button (same as the Enter or Return key). The big X is a deselect button (same as clicking elsewhere to deselect). Identical variable names can occur in a source file, so you often need to click on the line that has the variable to provide the correct context for the data window. If you forget the context of a variable in the data window, you can find out using the “Show Context” menu item.

If you want to look at the members of a structure or the contents of a structure for which you’ve got the pointer or handle, you double-click on the data (right side of the Data window) to deference to the next level, until you bring up a new data window that has the structure members (Figure 1, *bullseyeWindow).

You can edit the source within the debugger, a convenient feature when you find some nasty critter in your code. (Of course the changes don’t take effect until you recompile.) The debugger remembers the original, unedited source as long as memory constraints allow.

The debugger is friendly, full-functioned and fast. It integrates nicely into the environment. Though I have crashed in the debugger upon occasion, I consider it relatively stable.

Documentation

Two 7 1/2 x 9 x 3/8 inch manuals come with THINK C 3.0: a 260 page User’s Manual, and a 212 page Standard Libraries Reference. The manuals are high-quality soft cover perfect bound (like a regular book). One nice feature of the manual is an outer shell cover to the binding (called otabinding), so you can lie the book flat and can’t break the spine of the manual. It is indicative of the entire THINK C package in that great attention has been paid to getting the details right.

Of course, what’s inside the manuals is what really counts. The documentation has been completely rewritten, and is a vast improvement over version 2.15. The User’s Manual begins with a thorough tutorial, followed by a reference section. The writing is clear, concise and complete. The Standard Libraries Reference is a listing and explanation of the standard C and Unix library functions included with THINK C.

Conclusions

THINK C is so easy to use that it makes a fine backyard for a novice C code puppy, yet is full featured and slick enough for the professional code dog at the corporate kennel. Many Mac software houses, including Altsys, use it for their product development. The source-level debugger empowers THINK C 3.0, making its use a more pleasurable and highly productive experience.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

HoudahSpot 4.3.4 - Advanced file-search...
HoudahSpot is a versatile desktop search tool. Use HoudahSpot to locate hard-to-find files and keep frequently used files within reach. HoudahSpot will immediately feel familiar. It works just the... Read more
Hopper Disassembler 4.3.10- - Binary dis...
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
Hopper Disassembler 4.3.10- - Binary dis...
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
Paparazzi! 1.0b7 - Make user-defined siz...
Paparazzi! is a small utility for OS X that makes screenshots of webpages. This very simple tool takes screenshots of websites which do not fit on one screen. You specify the desired width, minimal... Read more
Amadeus Pro 2.4.4 - Multitrack sound rec...
Amadeus Pro lets you use your Mac for any audio-related task, such as live audio recording, digitizing tapes and records, converting between a variety of sound formats, etc. Thanks to its outstanding... Read more
Google Chrome 63.0.3239.108 - Modern and...
Google Chrome is a Web browser by Google, created to be a modern platform for Web pages and applications. It utilizes very fast loading of Web pages and has a V8 engine, which is a custom built... Read more
Apple Configurator 2.6 - Configure and d...
Apple Configurator makes it easy to deploy iPad, iPhone, iPod touch, and Apple TV devices in your school or business. Use Apple Configurator to quickly configure large numbers of devices connected to... Read more
WhatRoute 2.0.26 - Geographically trace...
WhatRoute is designed to find the names of all the routers an IP packet passes through on its way from your Mac to a destination host. It also measures the round-trip time from your Mac to the router... Read more
Remotix 5.0.4 - Access all your computer...
Remotix is a fast and powerful application to easily access multiple Macs (and PCs) from your own Mac. Features Complete Apple Screen Sharing support - including Mac OS X login, clipboard... Read more
WhatRoute 2.0.26 - Geographically trace...
WhatRoute is designed to find the names of all the routers an IP packet passes through on its way from your Mac to a destination host. It also measures the round-trip time from your Mac to the router... Read more

Latest Forum Discussions

See All

WWE Mayhem guide - beginner tips and tri...
WWE Mayhem brings all of the familiar faces from your favorite wrestling league to mobile in this exciting new fighting game. Build up a team of your favorite WWE superstars and fight your way to the championship title, or battle against your... | Read more »
The best new games we played this week -...
We've made it through another week, so let's treat ourselves to some of the best new games to launch in the past few days. It was another exciting week with some long-awaited indie games making their debut, and some big console titles making the... | Read more »
Match blocks to pull off dance moves in...
Ferdinand: Unstoppabull is a brand new match three puzzler based on the animated movie of (almost) the same name. As you can expect, you have to match blocks together to complete a bunch of puzzling levels and earn a high score. [Read more] | Read more »
Lineage 2: Revolution’s end of year upda...
Now available in 54 countries worldwide, Lineage 2: Revolution is continuing its global quest to be the most popular mobile MMORPG by launching a jam-packed end of year update. Complete with many subtle tweaks to help improve users’ online... | Read more »
The 5 best Star Wars games on iOS
The time has almost come.Star Wars: The Last Jedifinally hits theaters in the cinematic event that might be bigger than Christmas. To celebrate, we're taking a look at the best--and only the best--Star Warsmobile games to date. [Read more] | Read more »
Life Is Strange (Games)
Life Is Strange 1.1 Device: iOS Universal Category: Games Price: $2.99, Version: 1.1 (iTunes) Description: Life Is Strange is a five part episodic game that sets out to revolutionize story-based choice and consequence games by... | Read more »
Oddworld: New 'n' Tasty (Game...
Oddworld: New 'n' Tasty 1.0 Device: iOS Universal Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: ** PLEASE NOTE: Requires 3.6GB free space to install. Runs at variable resolutions based on device capabilities.... | Read more »
Gorogoa (Games)
Gorogoa 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Gorogoa is an elegant evolution of the puzzle genre, told through a beautifully hand-drawn story designed and illustrated by Jason... | Read more »
Why Guns of Boom will be big for mobile...
Earlier this week, Game Insight, the minds that brought you Guns of Boom, revealed plans for an esports mode in the popular FPS title, with big implications for the game's future. Guns of Boom has been quite popular for some time now, so it's... | Read more »
The best mobile games to play on lazy ho...
With the holidays in full swing, there's hopefully going to be a lot of time off work lazing around the house. With all of that free time, it's a perfect opportunity to catch up on some mobile games that you might have missed out on earlier this... | Read more »

Price Scanner via MacPrices.net

B&H Holiday sale: MacBooks for up to $300...
B&H Photo has Apple MacBook Pros, MacBook Airs, and 12″ MacBooks on sale for up to $300 off MSRP as part of their Holiday sale. B&H charges sales tax in NY & NJ only, and overnight... Read more
The lowest prices on Apple 13″ MacBook Pros t...
Save $300-$300 on the purchase of a 2017 13″ MacBook Pro this weekend with Certified Refurbished models at Apple. In many cases, Apple’s refurbished prices are the lowest available for each model... Read more
Lowest prices of the Holiday season: 15″ Appl...
Save $360-$420 on the purchase of a 2017 15″ MacBook Pro with Certified Refurbished models at Apple. In many cases, Apple’s refurbished prices are the lowest available for each model from any... Read more
Apple discounts Beats products by up to 30% t...
Apple has Beats by Dr. Dre (BeatsX, Powerbeats3 Wireless, and Beats Solo3 Wireless) on sale for up to 30% off their retail price from now until December 26th: – BeatsX: Was $149.95, now $99 –... Read more
Updated Price Trackers: Macs, iPads, iPhones,...
Scan our Apple Price Trackers for the latest information on sales, bundles, and availability on systems from Apple’s authorized internet/catalog resellers. We update the trackers continuously: – 15″... Read more
How to preorder a new iMac Pro and pay zero s...
B&H Photo and Adorama are accepting preorders on multiple configurations of the new Apple iMac Pro. Both resellers charge sales tax for residents of NY & NJ only, and shipping is free.... Read more
Apple Macs back in stock at Amazon with model...
Amazon has MacBook Pros, MacBook Airs, MacBooks, and iMacs on sale for up to $200 off MSRP as part of their Holiday/Christmas sale. Shipping is free. Note that stock of some Macs may come and go (and... Read more
Apple offering free overnight delivery on all...
Apple is now offering free overnight delivery on all in stock products until 3pm local time on December 22nd. This includes new as well as refurbished computers. Click here for more information. Read more
Beats Holiday sale at B&H, headphones and...
B&H Photo has Beats by Dr. Dre headphones, earphones, and speakers on sale for up to $80 off MSRP as part of their Holiday sale. Expedited shipping is free, and B&H charges sales tax to NY... Read more
Holiday sale: Apple resellers offer 2017 15″...
MacMall has 15″ MacBook Pros on sale for $220-$300 off MSRP, each including free shipping: – 15″ 2.8GHz MacBook Pro Space Gray (MPTR2LL/A): $2179, $220 off MSRP – 15″ 2.8GHz MacBook Pro Silver (... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.