rspec/rules/S1151/rpg/rule.adoc

83 lines
2.0 KiB
Plaintext

== Why is this an issue?
The ``++SELECT++`` statement should be used only to clearly define some new branches in the control flow. As soon as a ``++WHEN++`` clause contains too many statements this highly decreases the readability of the overall control flow statement. In such case, the content of ``++WHEN++`` clause should be extracted in a dedicated subroutine.
=== Noncompliant code example
With the default threshold of 5:
[source,rpg]
----
C SELECT
C WHEN X=1
C MOVE A B
C MOVE C D
C MOVE E F
C MOVE J K
C MOVE L M
C WHEN X=2
C ....
C ENDSL
/free
select;
when X=1;
B = A;
D = C;
F = E;
K = J;
M = L;
when X=2;
...
endsl;
/end-free
----
=== Compliant solution
[source,rpg]
----
C SELECT
C WHEN X=1
C EXSR SR011
C WHEN X=2
C ....
C ENDSL
C ...
C SR011 BEGSR
C MOVE A B
C MOVE C D
C MOVE E F
C MOVE J K
C MOVE L M
C ENDSR
/free
select;
when X=1;
exsr SR011;
when X=2;
...
endsl;
/end-free
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
Reduce this "[WHEN|OTHER]" number of lines of code from {} to at most {}, for example by extracting code into a [method|subroutine|function].
include::../parameters.adoc[]
'''
== Comments And Links
(visible only on this page)
include::../comments-and-links.adoc[]
endif::env-github,rspecator-view[]