STRING_SPLIT_AT_POSITION SAP Function module - Split a string with a proper position into two parts

STRING_SPLIT_AT_POSITION is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name STRING_SPLIT_AT_POSITION into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: CSTR
Released Date: Not Released
Processing type: Normal fucntion module

Pattern for FM STRING_SPLIT_AT_POSITION - STRING SPLIT AT POSITION

CALL FUNCTION 'STRING_SPLIT_AT_POSITION' "Split a string with a proper position into two parts
  EXPORTING
    string =                    " c             Character string to be demounted
    pos =                       " i             Position
*   langu = SY-LANGU            " sy-langu      Language of the text of STRING
  IMPORTING
    string1 =                   " c             Head of STRING in front of POS
    string2 =                   " c             Tail of STRING behind POS
    pos_new =                   " i             Actual position
  EXCEPTIONS
    STRING1_TOO_SMALL = 1       "               Output field STRING1 too briefly
    STRING2_TOO_SMALL = 2       "               Output field STRING2 too briefly
    POS_NOT_VALID = 3           "               Invalid input parameter of POS
    .  "  STRING_SPLIT_AT_POSITION

ABAP code example for Function Module STRING_SPLIT_AT_POSITION

The ABAP code below is a full code listing to execute function module STRING_SPLIT_AT_POSITION including all data declarations. The code uses the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the original method of declaring data variables up front. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8).

DATA:
ld_string1  
 
 TYPE C
,
ld_string2  
 
 TYPE C
,
ld_pos_new  
 
 TYPE I
.


DATA(ld_string) = 'Check type of data required'.

DATA(ld_pos) = 'Check type of data required'.

DATA(ld_langu) = 'Check type of data required'.
.

CALL FUNCTION 'STRING_SPLIT_AT_POSITION'
  EXPORTING
    string =                     ld_string
    pos =                        ld_pos
*   langu =                      ld_langu
  IMPORTING
    string1 =                    ld_string1
    string2 =                    ld_string2
    pos_new =                    ld_pos_new
  EXCEPTIONS
    STRING1_TOO_SMALL =          1
    STRING2_TOO_SMALL =          2
    POS_NOT_VALID =              3
    .  "  STRING_SPLIT_AT_POSITION

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 3. "Exception
  "Add code for exception here
ENDIF.

ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:

ld_string1
 
 TYPE C ,
ld_string
 
 TYPE C ,
ld_string2
 
 TYPE C ,
ld_pos
 
 TYPE I ,
ld_pos_new
 
 TYPE I ,
ld_langu
 
 TYPE SY-LANGU .


ld_string = 'Check type of data required'.
ld_pos = 'Check type of data required'.
ld_langu = 'Check type of data required'.