Importance of Coding Standards

Programming Help for Beginners

We write programs to instruct computers. When programming using a high level programming language like C++ or Java, we are using a syntax that is somewhat closer to human languages. However, we use these programs as inputs to either compilers or interpreters to be converted to computer understandable binary format. For this reason, as far as the program code adheres to the syntax of the used programming languages, the compilers and interpreters never bother about the layout or visual formatting of the program code. However, as human programmers, we ourselves need to bother about the aesthetics of the program code.

What is a Coding Standard?

A coding standard is a set of guidelines, rules and regulations on how to write code. Usually a coding standard includes guide lines on how to name variables, how to indent the code, how to place parenthesis and keywords etc. The idea is to be consistent in programming so that, in case of multiple people working on the same code, it becomes easier for one to understand what others have done. Even for individual programmers, and especially for beginners, it becomes very important to adhere to a standard when writing the code. The idea is, when we look at our own code after some time, if we have followed a coding standard, it takes less time to understand or remember what we meant when we wrote some piece of code.

Coding Standards Make a Difference

Look at the following example:

int volume(int i, int j, int k) {
int vol;
vol = i * j * k;
return vol;
}

Looking at this code at a glance, it takes some time for one to understand that this function calculates the volume. However if we adhere to a naming convention for variables and method names, we could make the code more readable.

Here are few sample conventions:

  • use meaningful variable names
  • use verbs in method names
  • use nouns for variables
  • use 4 spaces to indent
  • int calculateVolume(int height, int width, int length) {
    int volume = 0;
    volume = height * width * length;
    return volume;
    }

    It takes more time to type this code, however this saves far more time. This code is far more readable than its original version. With a little bit of effort, we could make the code much more understandable.

    The Benefits

    It is not only the readability that we get through a coding standard in programming. Writing more secure code could also be encouraged through a coding convention. As an example, in C++ we could say that each pointer variable must be initialized to NULL.

    char* myName = NULL;

    This ensures that we would not corrupt memory while using this pointer variable.

    Code readability is just one of the aspects of maintainability. Coding standards help a great deal with program maintainability, our ability to change programs with ease. Consistency imposed through a coding standard is a key factor to achieve success in maintaining prorams.

    Defining Your Own Coding Standard

    A programmer can define his or her own coding convention and adhere to that in writing programms. However there are many coding conventions available on the Internet. Those who program in Java should have a look into http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html - Code Conventions for the Java Programming Language by Sun.

    For C++ coding standards, I would recommend that you have a look into http://www.bbc.co.uk/guidelines/webdev/AppB.Cpp_Coding_Standards.htm - C++ Coding Standards from BBC.

    http://oopweb.com/CPP/Documents/CPPHOWTO/Volume/C++Programming-HOWTO-14.html - C++ Programming HOWTO has some C++ Coding Conventions and also a bunch of links that lead to several coding standards that you can pick from.

    John Dirk
    Programming Consultant
    http://www.programminghelp4u.com/
    Programming ( Assignment / Project ) Help

    In The News:


    pen paper and inkwell


    cat break through


    OSI Layers Model

    IntroductionDuring the early years of our modern computer era, very... Read More

    Choose your Java Wisely

    Java has come along a long way. Many would agree... Read More

    Online PowerPoint Presentation ? Convert PowerPoint to Flash

    Although we don't know whether Microsoft ever envisioned such a... Read More

    Microsoft Great Plains POP: Purchase Order Processing ? Overview For Consultants

    Great Plains Purchase Order Processing (POP) module makes up one-third... Read More

    You Can Write Microsoft Office Program in About 60 Minutes

    Microsoft Office program is a programming tool called Visual Basic... Read More

    Kick-Ass Performance For Your PC? Its Easy

    Is your PC is slow and wimpy? Then you need... Read More

    A Time-Saving Programming Tactic that Doesn?t Work

    Let's say that you have a software project that's under... Read More

    Microsoft Great Plains Integration Manager: Using Continuum ? Overview for Developer

    Microsoft Business Solutions Great Plains has I'd say end user... Read More

    Anti-Virus Software

    Anti-virus software is used to find, remove or fix files... Read More

    Microsoft Great Plains Customization: Project Organization ? International Business Example

    Microsoft Business Solutions Great Plains fits to majority of horizontal... Read More

    Removing Incoming Email in MS Exchange, C# Example

    The purpose of one of our projects was MS Exchange... Read More

    Microsoft Axapta, Navision or Great Plains: ERP Selection for Large Corporation

    If you would like to pick something from Microsoft, or... Read More

    Windows Screensavers Explained

    In this article you will find some background information about... Read More

    Microsoft Great Plains on Ctree or Pervasive SQL ? What to Do ? Tips for IT Manager

    As you probably know, when Microsoft purchased Great Plains Software... Read More

    Microsoft CRM USA Nationwide Remote Support

    Remember old good days when your company probably had Great... Read More

    Microsoft Navision Customization and Reporting ? Tips For Programmer/IT Specialist

    C/SIDE (Client/Server Integrated Development Environment) - The core of... Read More

    SpyBot - Search and Destroy versus Microsoft AntiSpyware (Beta).... My personal experiences...

    Ok... Where to start?Well, I guess I will start at... Read More

    Bill of Lading ? Custom Reporting for Microsoft Great Plains ? Overview for Consultant

    Bill of Lading is required report for Logistics and Freight... Read More

    Internet Faxing Service Review

    The Internet is reshaping every form of communications medium, and... Read More

    EDI: Electronic Document Interchange for Microsoft Great Plains ? Overview for Software Developer/Pr

    Microsoft Great Plains - Microsoft Business Solutions accounting and ERP... Read More

    Unofficial Windows 98 SE Service Pack 2.0 RC2

    Microsoft has never released a service pack for Windows98 SE,... Read More

    Microsoft Business Solutions Customization Options - Overview for Programmer

    Several years ago Microsoft purchased Great Plains Software, then Navision... Read More

    Great Plains Dexterity Development: FAQ

    Microsoft Business Solutions Great Plains is Dexterity-written application and currently... Read More

    Instant Messaging is a Sweet Way to Communicate

    MSN messenger is a pretty cool invention. I mean I'm... Read More

    Make 2005 the Year You Save Time!

    Today's business world is fast-paced. No matter what it is... Read More

    Microsoft CRM or Siebel

    Siebel is traditional CRM market leader, however and mostly due... Read More

    Is Your Family Protected?

    When you think... Read More

    Instant Messenger Clients

    If you have been using the Internet for any amount... Read More

    Microsoft Great Plains implementation: Restaurants Supply Chain Management Example

    Microsoft Great Plains serves majority of US based horizontal and... Read More

    Microsoft Great Plains Integration with Microsoft Access ? Overview for Developer

    ... Read More

    How To Make Good Use of Spreadsheets

    Most computer users use spreadsheets software such as Microsoft Excel... Read More

    Manufacturing Solutions for Microsoft Great Plains ? Overview for Consultant

    Microsoft Business Solutions Great Plains has full-featured manufacturing set of... Read More

    Is Your Small Business Ready For A CRM Software Solution?

    I have yet to see a business that, sometimes in... Read More