ACCU Home page ACCU Conference Page
Search Contact us ACCU at Flickr ACCU at GitHib ACCU at Google+ ACCU at Facebook ACCU at Linked-in ACCU at Twitter Skip Navigation

Search in Book Reviews

The ACCU passes on review copies of computer books to its members for them to review. The result is a large, high quality collection of book reviews by programmers, for programmers. Currently there are 1918 reviews in the database and more every month.
Search is a simple string search in either book title or book author. The full text search is a search of the text of the review.
    View all alphabetically
Title:
Practical C Programming 3rd Edition
Author:
Steve Oualline
ISBN:
1 56592 306 5
Publisher:
O'Reilly
Pages:
428pp
Price:
£22-00
Reviewer:
Francis Glassborow
Subject:
beginner's c
Appeared in:
11-1
One of our experienced reviewers presented a favourable and positive review of this book. This presented me with a problem because I am reasonably familiar with the author's earlier work. I suspended publication of the review until I could determine whether the author had done his homework supported by careful technical reviewing. I much hoped that he had as his books have a fairly wide sale. I would much prefer that readers were spending money on technically correct books.

Note that this is a book aimed at relative novices and so it is important that the low-level code sets a good example. After an email discussion with the original reviewer he asked to withdraw his review.

When you read the following, in fairness to the author, remember that an experienced reviewer initially liked the book. However, like many experienced reviewers he had not actually worked through the whole book. Here is what I wrote to the original reviewer. - Francis Glassborow.

I have now had a chance to do a complete inspection of this book. I can see what impressed you because the author does a number of sensible things (they are almost all issues raised at a meeting at Blackwell's Bookshop a couple of years ago). Unfortunately there are a number of what I consider to be unacceptable deficiencies. In accord with my standard policy I will, if you wish, publish your original review but I shall (also in accordance with standard editorial policy) have to publish a review raising these deficiencies.

Among the problems I have are:

The continual gratuitous use of global variables [note that in the past I have argued in their favour where they offer some real advantage such as representing conceptually unique objects (singletons in current parlance)].

Unhelpful comments. For example on page 200 as part of a structure definition for a mailing label:

char state[2];  /* two-character abbreviation */

Why only two characters (no space for a null-terminator)? The comment says what is obvious but fails to explain a design decision. Actually replace the '2' by '3' and the comment might make some sense. Note that I opened the book completely at random and simply looked at the first piece of code. That is how easy it was to find a poor comment.

Poor naming conventions (to see some really bad ones look at chapter 22 where he names a number of functions with a prefix

in_
to show they all relate to the same object and then uses
in_comment
as a global state variable.

The misunderstanding of

const
in C (where he assumes that it is the same as C++) He makes choices that no experienced C programmer would make for variable types e.g. page 244 where he has
const char DATA_FILE[] = "numbers.dat";

  • why a const char, rather than a const char *or plain char?
  • why a global?
  • why hard code the file name?
His work is littered with magic numbers.

He repeatedly makes assumptions (such as that

fgets()
will terminate by reading a carriage return, when it could do so because it had filled the buffer).

I could (and if you wish will) go on about the multitude of other instances of bad examples however the piece de resistance is chapter 22 where a stupid (there is no other word for it) design results in really terrible code. This design and code is what I would expect from an average student who had not put his/her (incidentally he continually lapses into gratuitous use of male pronouns when there are easy alternatives) mind to a clean initial design. Note that this is the 3rd edition so he has had plenty of time to get this design an implementation up toacceptable levels.

By the way he assumes that the execution and source character sets will be coded in ASCII, I guess he either does not know or chose to ignore

isalpha, isdigit, isxdigit
etc.

Please do not misconstrue the above. I shudder when I look at some of my earlier reviews when finding some sane aspects coloured my assessment of an author's work. It is sometimes such a relief to find a book that uses

fgets()
and a few sane coding guidelines that the problems get over-looked.

Sadly, in this case, I think that the author's understanding of programming and C in particular is superficial. He reacts to criticism by correcting what he thinks are the errors but without understanding the issues.