split text( 'a' text, 'b' max length, 'c' name of result list, ['d' split char; default: blank] )


Splits the text in parameter a into substrings. From the left, the longest possible (maximum length b) substring that contains a blank (or the alternative separator in parameter d) as the last character is searched for. If such a substring cannot be formed, a substring of the maximum length b is formed from the left.

The created substring is added to list c. The procedure is repeated for the remaining text until it is empty.

The return value of the function is the number of substrings added to the list.

Description of Parameters

Parameter

Description

a

Text to be split.

b

Maximum length (values < 0 are replaced with 50).

c

Name of the list for the substrings.

d

(optional) Splitting char. Default: blank

Examples

Parameter a

Parameter b

Parameter c

Parameter d

Result

This message is used for testing!

10

list_text_split

5 (List list_text_split with values {This ,message ,is used ,for ,testing!})

ThisMessageIsUsedForTesting!

20

list_text_split

2 (List list_text_split with values {ThisMessageIsUsedFor,Testing!})

This_message_is_used_for_testing!

10

list_text_split

_

5 (List list_text_split with values {This_,message_,is_used_,for_,testing!})