Function EN Version 4.50

@CutList

Float List Misc NUMBER Text

Syntax

@CutList(FN1;TEXT2);

@CutList(FNLIST1;TEXT2);

@CutList(FNLIST1;TEXT2;TEXTLIST3);

Description

TEXT TEXT2 is split into the lengths specified in FN/FNLIST FN1/FNLIST1 and returned as TEXTLIST is returned.

If TEXTLIST TEXTLIST3 is present, in the case of 0 (NULL) in FN/FNLIST FN1/FNLIST1 the corresponding element from TEXTLIST TEXTLIST3 is used as seperator string.
The separator string itself is removed.
If "" (NULLSTRING) is specified as the corresponding element, the result TEXTLIST is a "" (NULLSTRING) Element.
If a separator is not found, the corresponding element up to the end of TEXT TEXT2 is used.

Excess characters from TEXT TEXT2 are not included in the result TEXTLIST is returned.

Example:@CutList(FN1;TEXT2);

FN1:=3;
TEXT2:="012345678901234567890123456789";

Ret:=@CutList(FN1;TEXT2);
@LogReport("<"+@Implode(Ret;"#")+">";3);

It is <012> reported at the APILOG.

Examples:@CutList(FNLIST1;TEXT2);

FNLIST1:=3:3:3;
TEXT2:="012345678901234567890123456789";

Ret:=@CutList(FNLIST1;TEXT2);
@LogReport("<"+@Implode(Ret;"#")+">";3);

It is <012#345#678> reported at the APILOG.

FNLIST1:=3:3:50;
TEXT2:="012345678901234567890123456789";

Ret:=@CutList(FNLIST1;TEXT2);
@LogReport("<"+@Implode(Ret;"#")+">";3);

It is <012#345#678901234567890123456789> reported at the APILOG.

FNLIST1:=3:3:0;
TEXT2:="012345678901234567890123456789";

Ret:=@CutList(FNLIST1;TEXT2);
@LogReport("<"+@Implode(Ret;"#")+">";3);

It is <012#345#> reported at the APILOG.

FNLIST1:=3:3:50:3;
TEXT2:="012345678901234567890123456789";

Ret:=@CutList(FNLIST1;TEXT2);
@LogReport("<"+@Implode(Ret;"#")+">";3);

It is <012#345#678901234567890123456789#> reported at the APILOG.

Examples:@CutList(FNLIST1;TEXT2;TEXTLIST3);

FNLIST1:=3:3:3;
TEXT2:="012345678901234567890123456789";
TEXTLIST3:="":"":"";