SAP NUMBERS GUIDL documentation, setup help and example usage

GUIDELINE 6.15

Specifying Numbers

ABAP_BACKGROUND
There are no special literals available for numbers with decimal places, or with mantissa plus exponent. If required, these numbers must be expressed using character literals. The following notations can be used:

Mathematical notation

A sequence of digits with a maximum of one period (.) as a decimal separator and an optional sign "+" or "-" on the left. This sign can be separated from the digits by blanks, for example: - 1234.56

Commercial notation

A sequence of digits with a maximum of one period (.) as a decimal separator and an optional sign "+" or "-" on the right. This sign can be separated from the digits by blanks, for example: 1234.56-

Scientific notation

A sequence consisting of a mantissa (an optional sign "+" or "-", digits with a maximum of one period (.) as a decimal separator), a character e or E , and an exponent (an optional sign "+" or "-" and further digits), for example: -1.23456E03

ABAP_RULE
Use globally valid notation for numeric values
When using numbers in character strings that are intended for assignments to a numeric data object, create them so that they are acc
epted by all possible target types. The sign must always be on the left, and there must be no blanks.

ABAP_DETAILS
When converting a character string to a numeric variable, the type of the target variables decides which notations are accepted:

If the type of the target variable is decfloat16 or

decfloat34 , all three notations are accepted.

If the type of the target variable is f , all three notations are accepted. The mathematic and commercial notations are only accepted, however, if the sign is not separated from the digits by one or more blanks and there are blanks in front of the digits.

If the type of the target variable is p or i , only the mathematic and commerical notations are accepted.

To make sure that a program is readable, and also that numbers in character strings can be converted to as many numeric data types as possible, always use mathematical notation without blanks between the sign and the digits. This notation also confirms to other standards, such as the canonic representation of XML schema data types.

Bad example
The following source code demonstrates the initialization of a generically typed parameter with commercial notation, where the sign is separated by a blank. If an actual parameter with a type other than f is passed, the assignment produces the value -1000 (as expected); if an actual parameter of the type f is passed, however, the value is +1000.
CLASS class DEFINITION.
PUBLIC SECTION.
METHODS calculate_something
EXPORTING number TYPE numeric.
ENDCLASS.
CLASS class IMPLEMENTATION.
METHOD calculate_something.
number = '1000 -'.
...
ENDMETHOD.
ENDCLASS.

Good example
The following source code demonstrates an assignment using globally valid notation that is easy to read and which produces the same result, the value -1000, for all numeric data types.
METHOD calculate_something.
number = '-1000'.
...
ENDMETHOD.

Documentation extract taken from SAP system, � Copyright SAP AG. All rights reserved