The EN data edit descriptor transfers values by using engineering notation. It takes the following form:
ENw.d[Ee]
The value of d (the number of places after the decimal point) plus e (the number of digits in the exponent) must not exceed the value of w (the field width).
The specified I/O list item must be of type real, or it must be the real or imaginary part of a complex type.
On input, the EN data edit descriptor transfers w characters from an external field and assigns their real value to the corresponding I/O list item. The EN descriptor interprets and assigns input data in the same way as the F data edit descriptor.
The following shows input using the EN edit descriptor (the symbol ^ represents a nonprinting blank character):
Format Input Value
EN11.3 ^^5.321E+00 5.32100
EN11.3 -600.00E-03 -.60000
EN12.3 ^^^3.150E-03 .00315
EN12.3 ^^^3.829E+03 3829.0
On output, the EN data edit descriptor transfers the real value of the corresponding I/O list item, right-justified and rounded to d decimal positions, to an external field that is w characters long. The real value is output in engineering notation, where the decimal exponent is divisible by 3 and the absolute value of the significand is greater than or equal to 1 and less than 1000 (unless the output value is zero).
The w should be greater than or equal to d+9 to allow for the following:
A sign (optional if the value is positive and descriptor SP is not in effect)
One to three digits to the left of the decimal point
The decimal point
The d digits to the right of the decimal point
The exponent
The exponent takes one of the following forms:
Edit Descriptor |
Absolute Value of Exponent |
Positive Form of Exponent |
Negative Form of Exponent |
|---|---|---|---|
ENw.d |
|exp| 99 |
E+nn |
E-nn |
99 < |exp| 999 |
+nnn |
-nnn |
|
ENw.dEe |
|exp| 10e - 1 |
E+n1n2...ne |
E-n1n2...ne |
If the exponent value is too large to be converted into one of these forms, an error occurs.
The exponent field width (e) is optional; if omitted, the default value is 2. If e is specified, the w should be greater than or equal to d + e + 5.
The following shows output using the EN edit descriptor (the symbol ^ represents a nonprinting blank character):
Format Value Output
EN11.2 475867.222 ^475.87E+03
EN11.5 475867.222 ***********
EN12.3 0.00069 ^690.000E-06
EN10.3 -0.5555 **********
EN11.2 0.0 ^000.00E-03