rspec/rules/S1862/php/rule.adoc
2022-02-04 16:28:24 +00:00

81 lines
1.8 KiB
Plaintext

A ``++switch++`` and a chain of ``++if++``/``++else if++`` statements is evaluated from top to bottom. At most, only one branch will be executed: the first one with a condition that evaluates to ``++true++``.
Therefore, duplicating a condition automatically leads to dead code. Usually, this is due to a copy/paste error. At best, it's simply dead code and at worst, it's a bug that is likely to induce further bugs as the code is maintained, and obviously it could lead to unexpected behavior.
For a ``++switch++``, if the first case ends with a ``++break++``, the second case will never be executed, rendering it dead code. Worse there is the risk in this situation that future maintenance will be done on the dead case, rather than on the one that's actually used.
On the other hand, if the first case does not end with a ``++break++``, both cases will be executed, but future maintainers may not notice that.
== Noncompliant Code Example
[source,php]
----
if ($param == 1)
openWindow();
else if ($param == 2)
closeWindow();
else if ($param == 1) // Noncompliant
moveWindowToTheBackground();
switch($i) {
case 1:
//...
break;
case 3:
//...
break;
case 1: // Noncompliant
//...
break;
default:
// ...
break;
}
----
== Compliant Solution
[source,php]
----
if ($param == 1)
openWindow();
else if ($param == 2)
closeWindow();
else if ($param == 3)
moveWindowToTheBackground();
switch($i) {
case 1:
//...
break;
case 3:
//...
break;
default:
// ...
break;
}
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
include::../message.adoc[]
include::../highlighting.adoc[]
'''
== Comments And Links
(visible only on this page)
include::comments-and-links.adoc[]
endif::env-github,rspecator-view[]