Naming

The Practice of Programming

• Use capital letter for constant

#define ONE 1

• Include a brief comment with the declaration of each global
• Use descriptive names for global.

int npending = 0; // current length of input queue

• Use short names for locals. Compare

for (theElementIndex = 0; theElementIndex < numberOfElements; theElementIndex++)
  elementArray[theElementIndex] = theElementIndex;

to

for (int i =0; i < nelems; i++)
   elem[i] = i;

• Other naming conventions and local customs.
  • Use names that begin or end with p, such as nodep, for pointers;
  • Initial capital letters for globals;
  • All capitals for constants;
  • Use pch to mean a pointer to a character;
  • strTo and strFrom to mean strings that will be written to and read from;
  • It is a matter of taste as for the spelling of the names themselves: npending or or numPending or num_pending.
• Be consistent. Give related things related names that show their relationship and highlight their difference. For example

class UserQueue {
  int noOfItemsInQ, frontOfTheQueue, queueCapacity;
  public int noOfUsersInQueue() { ... }
}

can be better changed to

class UserQueue {
  int nitems, front, capacity;
  public int nusers() { ... }
}

• Use active name for functions. Functions names should be based on active verbs, perhaps followed by nouns:

now = date.getTime();
putchar('\n');

Functions that return a boolean value should be named so that the return value is unambiguous. Thus

if (checkoctal(c)) ...

does not indicate which value is true and which is false, while

if (isoctal(c)) ...

makes it clear that the function returns true if the argument is octal and false if not.

• Be accurate. A name not only labels, it conveys information to the reader. For example, the function name below is doing the opposite of what it has been implemented.

public boolean inTable(Object obj) {
  int j = this.getIndex(obj);
  return( j == nTable);
}