rspec/rules/S109/vb6/rule.adoc

33 lines
931 B
Plaintext
Raw Normal View History

2020-06-30 10:16:44 +02:00
A magic number is a number that comes out of nowhere, and is directly used in a statement. Magic numbers are often used, for instance to limit the number of iterations of a loops, to test the value of a property, etc.
2021-02-02 15:02:10 +01:00
2020-06-30 10:16:44 +02:00
Using magic numbers may seem obvious and straightforward when you're writing a piece of code, but they are much less obvious and straightforward at debugging time.
2021-02-02 15:02:10 +01:00
2020-06-30 10:16:44 +02:00
That is why magic numbers must be demystified by first being assigned to clearly named constants before being used.
2021-02-02 15:02:10 +01:00
2020-06-30 10:16:44 +02:00
-1, 0 and 1 are not considered magic numbers.
== Noncompliant Code Example
----
Function blnCheckSize(dblParameter As Double) As Boolean
If dblParameter > 1024 Then
blnCheckSize = True
End If
End Function
----
== Compliant Solution
----
Function blnCheckSize(dblParameter As Double) As Boolean
Dim threshold As Integer = 1024
If dblParameter > threshold Then
blnCheckSize = True
End If
End Function
----