SAP TYPE FORMAL PARAM - Guide



Get Example source ABAP code based on a different SAP table
  



Typing of Formal Parameters

ABAP_BACKGROUND
The typing of formal parameters can be full or generic. Formal parameters of methods must be, and formal parameters of function modules and subroutines should be, explicitly typed using the TYPE or LIKE addition. When actual parameters are bound to formal parameters, the system checks whether the data type of the actual parameter matches the typing of the formal parameter.
Full typing completely defines the data type of a formal parameter and applies to both dynamic access and static access to the formal parameter.
Generic typing does not define the data type of a formal parameter in full. Instead, the actual data type of the supplied actual parameter is used. The properties of the actual parameter apply to dynamic access performed on formal parameters like this. The properties defined by the typing apply to static access.
For generic typing, a set of built-in generic types is available in ABAP, which are only intended for the typing of formal parameters and field symbols. Using them in any other way can lead either to errors or to missing properties being filled with default values. The generic types are: any, any table, c, clike, csequence, data, decfloat, hashed table, index table, n, numeric, object, simple, sorted table, standard table, table, x , and xsequence. User-defined table types without fully specified table keys are also generic.

ABAP_RULE
Be as specific as possible when typing formal parameters
Be only as generic as necessary when typing formal parameters. Fully generic types (any) should be the exception rather than the rule. When used, a formal parameter must be compliant with all possible fixed types.

ABAP_DETAILS
Absolute type security within a procedure can only be achieved using full typing. It should always be used when providing a generic service is not a defined goal. It is much easier to carry out tests for non-generic services than for generic services.
A generically typed procedure interface usually involves more implementation effort within the procedure ( method) to avoid runtime errors. Therefore, use the following principle when providing generic interfaces: as little generic typing as possible and as much generic typing as necessary. You should use specific generic types, such as numeric or csequence, instead of any or data, for example, if services are involved that are supposed to process numeric values or character strings. However, already when csequence is used, you must take into account that the possible concrete types c and string behave differently with respect to trailing blanks. or that the concrete numeric types that are possible for numeric lead to different calculation types in calculations. Especially, when existing typings are generalized, it may be necessary to modify the implementation accordingly.
Generic typing can be a pitfall if you are not aware that you have used generic typing instead of full typing, because only the technical type properties are checked when an actual parameter is connected, but no component names, for example. This can lead to different behavior than expected.



Latest notes:

These statements about typing apply equally to field symbols.
In typings of formal parameters with the generic type data, it should be noted that no numeric functions, no description functions, and no arithmetic expressions can be passed to these parameters. This restriction can be bypassed by applying the conversion operator CONV to the actual parameter. This restriction does not apply to the generic type any , however, which means that, if required, a typing with the generic type any is recommended.
ABAP_HINT_END
BEGIN_SECTION SAP_INTERNAL_HINT
The behavior for data is a bug that cannot be resolved.
END_SECTION SAP_INTERNAL_HINT

ABAP_EXAMPLE_BAD
The following method shows different behavior when a blank is passed as a string of the type string or as a text field of the type c .
ABEXA 01362
ABAP_EXAMPLE_END

ABAP_EXAMPLE_GOOD
Using the built-in function condense produces the same behavior when a blank is passed, regardless of the fixed type.
ABEXA 01363
ABAP_EXAMPLE_END

ABAP_EXAMPLE_BAD
The example in the following source code shows the trap you can fall into, particularly when working with table types, if the table key is not specified in full their declaration (in a program or in ABAP Dictionary). Due to the missing key specification, the table type that is used to type the formal parameter of sort_itab is generic. While the first static sort is successful, the second SORT statement fails and raises a runtime error. For the dynamic component specification, the properties of the actual parameter apply to the formal parameter, and the actual parameter does not have the col2 component (this can also be tracked in the ABAP Debugger). CLASS class DEFINITION.
PUBLIC SECTION.
TYPES: BEGIN OF struc,
col1 TYPE type1,
col2 TYPE type2,
END OF struc,
itab TYPE STANDARD TABLE OF struc.
METHODS: main,
sort_itab CHANGING c_itab TYPE itab.
ENDCLASS. CLASS class IMPLEMENTATION.
METHOD main.
TYPES: BEGIN OF struc,
col1 TYPE type1,
col3 TYPE type2,
END OF struc.
DATA itab TYPE STANDARD TABLE OF struc
WITH NON-UNIQUE KEY col1 col3.
...
sort_itab( CHANGING c_itab = itab ).
ENDMETHOD.
METHOD sort_itab.
SORT c_itab BY col1 col2.
SORT c_itab BY ('COL1') ('COL2'). ' < - Runtime error!
ENDMETHOD.
ENDCLASS.
ABAP_EXAMPLE_END

ABAP_EXAMPLE_GOOD
The following source code shows a very simple correction of the typing in the above example. Because the primary table key is specified in full, the type used is no longer generic, and dynamic sorts work like static sorts. ...
itab TYPE STANDARD TABLE OF struc
WITH NON-UNIQUE KEY col1 col2.
...
ABAP_EXAMPLE_END