Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Minor edits; reviewed

Do not use the assignment operator in the following contexts because it typically indicates programmer error and can result in unexpected behavior:

OperatorContext 
if

...

controlling expression

...

while

...

controlling expression

...

do ... while

...

controlling expression

...

for

...

second operand

...

?:

...

first operand

...

?:second or third operands, where the ternary expression is used in any of these contexts

...

&& either operand 
|| either operand 
, operator second operand, when the comma expression is used in any of these contexts

Noncompliant Code Example

In this noncompliant code example, an assignment expression is the outermost expression in an if statement:

...

Although the intent of the code may be to assign b to a and test the value of the result for equality to 0, it is very frequently a case of the programmer mistakenly using the assignment operator = instead of the equals operator ==. Consequently, many compilers will warn about this condition, making this coding error detectable by adhering to MSC00-C. Compile cleanly at high warning levels.

Compliant Solution (Unintentional Assignment)

When the assignment of b to a is not intended, this conditional block is now executed when a is equal to b:

Code Block
bgColor#ccccff
langc
if (a == b) {
  /* ... */
}

Compliant Solution (Intentional Assignment)

When the assignment is intended, the following is an alternative compliant solution:

...

It is less desirable in general, depending on what was intended, because it mixes the assignment in the condition, but it is clear that the programmer intended the assignment to occur.

Noncompliant Code Example

In this noncompliant example, the expression x = y is used as the controlling expression of the while statement:

Code Block
bgColor#FFcccc
langc
 do { /* ... */ } while ( foo(), x = y ) ;

Compliant Solution (Unintentional Assignment)

When the assignment of y to x is not intended, this conditional block is now executed when x is equal to y:

Code Block
bgColor#ccccff
langc
do { /* ... */ } while ( foo(), x == y ) ; 

Compliant Solution (Intentional Assignment)

When the assignment is intended, the following is an alternative compliant solution:

Code Block
bgColor#ccccff
langc
do { /* ... */ } while ( foo(), (x = y) != 0 ) ;

Noncompliant Code Example

In this noncompliant example, the expression p = q is used as the controlling expression of the while statement:

Code Block
bgColor#FFcccc
langc
 do { /* ... */ } while ( x = y, p = q ) ;

Compliant Solution

This is a compliant example because the expression x = y is not used as the controlling expression of the while statement:

Code Block
bgColor#ccccff
langc
do { /* ... */ } while ( x = y, p == q ) ; 

Exceptions

EXP45-EX1: Assignment can be used where the result of the assignment is itself a parameter to a comparison expression or relational expression. In this compliant example, the expression x = y  is itself a parameter to a comparison operation:

Code Block
bgColor#ccccff
langc
if ( ( x = y )  != 0  ) { /* ... */ } 

EXP45-EX2: Assignment can be used where the expression consists of a single primary expression. In this compliant example, the expression  x = y is a single primary expression:

Code Block
bgColor#ccccff
langc
if ( ( x = y ) ) { /* ... */ } 

EXP45-EX3: Assignment can be used in the above contexts if it occurs in a function argument or array index. In this compliant example, the expression x = y is used in a function argument:

...

Code Block
bgColor#ccccff
langc
if ( foo( x = y ) ) { /* ... */ } 

This is a noncompliant example because && is not a comparison or relational operator and the entire expression is not primary:

Code Block
bgColor#FFcccc
langc
if ( ( v = w ) && flag ) { /* ... */ }

When the assignment of v to w is not intended, this conditional block is now executed when v is equal to w:

Code Block
bgColor#ccccff
langc
if ( ( v == w ) && flag ) { /* ... */ }; 

When the assignment is intended, the following is an alternative compliant solution:

Code Block
bgColor#ccccff
langc
if ( ( (v = w) != 0 ) && flag ) { /* ... */ };

Risk Assessment

...

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

Related Guidelines

...