Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This noncompliant code example fails to test for conditions where a is neither b nor c. This behavior may be the correct in this case, but failure to account for all the values of a can result in logic errors if a unexpectedly assumes a different value.

...

Code Block
bgColor#ccccff
langc
if (a == b) {
  /* ... */
}
else if (a == c) {
  /* ... */
}
else {
  /* handleHandle error condition */
}

Noncompliant Code Example (Switch)

...

Code Block
bgColor#ccccff
langc
typedef enum { Red, Green, Blue } Color;
const char* f(Color c) {
  switch (c) {
    case Red: return "Red";
    case Green: return "Green";
    case Blue: return "Blue";
    default: return "Unknown color";   /* necessaryNecessary */
  }
}

Note that adding a default case to a switch statement, even when all possible switch labels are specified, is an exception (MSC07-EX1) to MSC07-C. Detect and remove dead code.

...

Code Block
bgColor#ccccff
langc
typedef enum { Red, Green, Blue } Color;
const char* f(Color c) {
  switch (c) {
    case Red: return "Red";
    case Green: return "Green";
    case Blue: return "Blue";
  }
  return "Unknown color";   /* necessaryNecessary */
}

Historical Discussion

...

Code Block
bgColor#FFCCCC
langc
#define ORIGINYEAR 1980
UINT32 days = /* numberNumber of days since January 1, 1980 */
int year = ORIGINYEAR;
/* ... */

while (days > 365) {
  if (IsLeapYear(year)) {
    if (days > 366) {
      days -= 366;
      year += 1;
    }
  }
  else {
    days -= 365;
    year += 1;
  }
}

...

The following proposed rewrite is provided by at http://wwwwinjade.aeroxp.orgnet/2009/01/lesson-on-infinite-loops. The loop is guaranteed to exit, because days decreases for each iteration of the loop, unless the while condition fails , and the loop terminates.

Code Block
bgColor#ccccff
langc
#define ORIGINYEAR 1980
UINT32 days = /* inputInput parameter */
int year = ORIGINYEAR;
/* ... */

int daysThisYear = (IsLeapYear(year) ? 366 : 365);
while (days > daysThisYear) {
  days -= daysThisYear;
  year += 1;
  daysThisYear = (IsLeapYear(year) ? 366 : 365);
}

...

LDRA_V

Tool

Version

Checker

Description

LDRA tool suite

Include Page

LDRA_V

12 S

Fully implemented.GCC
Include Page
GCC_VGCC_V 

Can detect some violations of this recommendation when the -Wswitch and -Wswitch-default flags are used.

Compass/ROSE

  

Can detect some violations of this recommendation. In particular, it flags switch statements that do not have a default clause. ROSE should detect "fake switches" as well (that is, a chain of if statements each checking the value of the same variable). These if statements should always end in an else clause, or they should mathematically cover every possibility. For instance, consider the following:

  if (x > 0) {
	  /* ... */
  } else if (x < 0) {
    /* ... */
  } else if (x == 0) {
    /* ... */
  }
GCC
Include Page
GCC_V
GCC_V
 

Can detect some violations of this recommendation when the -Wswitch and -Wswitch-default flags are used.

 Klocwork 
Include Page
Klocwork_V
Klocwork_V
 LA_UNUSED 

LDRA tool suite

Include Page
LDRA_V
LDRA_V

12 S

Fully implemented.
PRQA QA-C
Include Page
PRQA_V
PRQA_V

0597
1460
1470
1472
2002
2004

Fully implemented

...

Search for vulnerabilities resulting from the violation of this rule on the CERT website.

Related Guidelines

...

MSC01-CPP. Strive for logical completeness
ISO/IEC TS 17961 (Draft)Use of an implied default in a switch statement [swtchdflt]
ISO/IEC TR 24772

...

Switch

...

Statements and Static Analysis [CLL]

Bibliography

...

[Hatton 1995]Section 2.7.2, "Errors of

...

Omission and

...

Addition"
[Viega 2005]Section 5.2.17, "Failure to

...

Account for

...

Default Case in

...

 http://www.aeroxp.org/2009/01/lesson-on-infinite-loops] for analysis on the Zune 30 bug