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


    Microsoft CRM Lotus Notes Domino Connector FAQ

    Microsoft Business Solutions CRM and IBM Lotus Notes Domino, being... Read More

    DB Integration - Software for Combine MS Access Databases

    Our company, Novaprof Inc., developed unique software - DB Integration.... Read More

    Upgrading Great Plains Dexterity Customization ? switching to new technologies: SQL, Crystal, eConne

    1. Replace Dexterity cursor with SQL Stored Procedure Dexterity... Read More

    Behave, Word, Behave!

    If you copy something from a Web site or elsewhere...... Read More

    Outlook... Not Just for Email! Using Your Outlook Calendar

    Microsoft Outlook is one of the most widely used software... Read More

    Crystal Reports for Microsoft Great Plains ? Overview for Developer

    Microsoft Great Plains is main accounting / ERP application... Read More

    Linux vs Windows Operating Systems

    With so many Microsoft Windows related viruses, errors, and other... Read More

    How To Develop Software For Your Business

    Software development is a risky business.Many software developers are barely... Read More

    Bridging the Gap between Paper and Data

    The cornerstone of successful automated office systems is the ability... Read More

    HelpDesk & Asset Management Software - Choosing The Right One

    If you are to buy a HelpDesk & Asset Management... Read More

    Importance of Coding Standards

    Programming Help for BeginnersWe write programs to instruct computers. When... Read More

    Does Microsoft have any real competition?

    Does Microsoft Have any Real Competition? Copyright (c) 2003 Gregory... Read More

    Microsoft Great Plains - Typical Problems And Fixes ? Overview For IT Administrators

    How to delete the user? This is the first problem... Read More

    Save Your Resources - Combine Your IM Clients

    There are so many different programs that clutter up your... Read More

    Start Developing Your Own Software

    Learning how to program software seems like a daunting task... Read More

    Microsoft Great Plains Customization Tools Evolution ? Overview for Consultant

    When Great Plains Software introduced the first graphical accounting application... Read More

    Microsoft Blues

    With the advent of 'Service Pack 2' for Windows XP... Read More

    Microsoft Update - 5 Reasons to Update Service Pack 2

    Microsoft released Service Pack 2 (SP2) for the Windows XP... Read More

    Helping Newbies Understand Professional Software

    The Windows registry is a huge database that ensures normal... 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

    Who?s Watching What You Type?

    If someone entered your home, uninvited and installed numerous cameras... Read More

    Introduction To ISDN, Part III: PAP

    Introduction To ISDN, Part III: Configuring PPP PAP AuthenticationNow we... Read More

    Navision Customization: C/SIDE, C/ODBC, C/FRONT, XBRL ? Development Options

    Microsoft bought Navision, Denmark based software development company, along with... Read More

    Spyware: What It Is and How to Combat It

    Spyware is software or hardware installed on a computer without... Read More

    Microsoft CRM Conversation Gateway: VoIP - Implementation & Customization

    Microsoft CRM is winning market share step-by-step from such the... Read More

    How to Backup Windows XP Home Edition

    Your computer cost you from hundreds to thousands of dollars,... Read More

    Instant Messaging is a Sweet Way to Communicate

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

    Linux ? Keyboard Or Mouse

    Just stress testing one of the latest Linux distributions. Been... Read More

    COSMIC: A Small Improvement on the Symons Method

    The COSMIC FP (function point) software quality metric, is no... Read More

    Great Plains Bill of Materials Setup & Customization for Process Manufacturing ? Overview

    Microsoft Great Plains has full-featured Manufacturing suite of modules: Capacity... Read More

    Spyware, Adware, etc. -- Terms and Common Sense

    When reading an article where some term is used often,... Read More

    Need of Document Management System (DMS)

    Document Management or Enterprise Information Management is perhaps one of... Read More

    Microsoft CRM Data Import FAQ

    Microsoft CRM has built-in conversion tool, however you should probably... Read More