Coding Standards and Guidelines
Coding standards are collections of coding rules, guidelines, and best practices.
Using the right coding standards — such as C coding standards Different modules
specified in the design document are coded in the Coding phase according to the
module specification. The main goal of the coding phase is to code from the design
document prepared after the design phase through a high-level language and then to
unit tests this code.
What are Coding Standards and Guidelines?
Good software development organizations want their programmers to maintain to
some well-defined and standard style of coding called coding standards. They usually
make their own coding standards and guidelines depending on what suits their
organization best and based on the types of software they develop. It is very important
for the programmers to maintain the coding standards otherwise the code will be
rejected during code review.
Purpose of Having Coding Standards
The following are the purpose of having Coding Standards:
A coding standard gives a uniform appearance to the codes written by different
engineers.
It improves readability, and maintainability of the code and it reduces complexity
also.
It helps in code reuse and helps to detect errors easily.
It promotes sound programming practices and increases the efficiency of the
programmers.
Coding Standards in Software Engineering
Some of the coding standards are given below:
1. Limited use of globals: These rules tell about which types of data that can be
declared global and the data that can’t be.
2. Standard headers for different modules: For better understanding and
maintenance of the code, the header of different modules should follow some
standard format and information. The header format must contain below things
that is being used in various companies:
Name of the module
Date of module creation
Author of the module
Modification history
Synopsis of the module about what the module does
Different functions supported in the module along with their input output
parameters
Global variables accessed or modified by the module
3. Naming conventions for local variables, global variables, constants and
functions: Some of the naming conventions are given below:
Meaningful and understandable variables name helps anyone to understand the
reason of using it.
Local variables should be named using camel case lettering starting with small
letter (e.g. localData) whereas Global variables names should start with a
capital letter (e.g. GlobalData). Constant names should be formed using capital
letters only (e.g. CONSDATA).
It is better to avoid the use of digits in variable names.
The names of the function should be written in camel case starting with small
letters.
The name of the function must describe the reason of using the function clearly
and briefly.
4. Indentation: Proper indentation is very important to increase the readability of the
code. For making the code readable, programmers should use White spaces
properly. Some of the spacing conventions are given below:
There must be a space after giving a comma between two function arguments.
Each nested block should be properly indented and spaced.
Proper Indentation should be there at the beginning and at the end of each block
in the program.
All braces should start from a new line and the code following the end of
braces also start from a new line.
5. Error return values and exception handling conventions: All functions that
encountering an error condition should either return a 0 or 1 for simplifying the
debugging.
Coding Guidelines in Software Engineering
Coding guidelines give some general suggestions regarding the coding style that to be
followed for the betterment of understandability and readability of the code.
Some of the coding guidelines are given below :
1. Avoid using a coding style that is too difficult to understand: Code should be
easily understandable. The complex code makes maintenance and debugging
difficult and expensive.
2. Avoid using an identifier for multiple purposes: Each variable should be given a
descriptive and meaningful name indicating the reason behind using it. This is not
possible if an identifier is used for multiple purposes and thus it can lead to
confusion to the reader. Moreover, it leads to more difficulty during future
enhancements.
3. Code should be well documented: The code should be properly commented for
understanding easily. Comments regarding the statements increase the
understandability of the code.
4. Length of functions should not be very large: Lengthy functions are very
difficult to understand. That’s why functions should be small enough to carry out
small work and lengthy functions should be broken into small ones for completing
small tasks.
5. Try not to use GOTO statement: GOTO statement makes the program
unstructured, thus it reduces the understandability of the program and also
debugging becomes difficult.
Advantages of Coding Guidelines
1. Coding guidelines increase the efficiency of the software and reduces the
development time.
2. Coding guidelines help in detecting errors in the early phases, so it helps to reduce
the extra cost incurred by the software project.
3. If coding guidelines are maintained properly, then the software code increases
readability and understandability thus it reduces the complexity of the code.
4. It reduces the hidden cost for developing the software.
