SPLIT text statement

[xvxx]

This is much nicer than #93. This patch implements the SPLIT statement that was already listed as a TODO in the source. It lets you easily just split a string or file into a vector and loop over that, and avoids all the caching nonsense.

DATA:
words is text vector
PROCEDURE:
SPLIT "hi there" BY " " IN words
DISPLAY words:1 crlf

output:

there

If you want to get all the characters, you can split by "":

SPLIT "hi there" BY "" IN letters
DISPLAY letters:1 crlf

output:

i

And of course, the whole point - it works with utf8:

split "🐈 say meow, 🐕 say woof" by "" in letters
display letters:0 crlf
display letters:6 letters:7 letters:8 letters:9 crlf
display letters:12 crlf

output:

🐈
meow
🐕

[Lartu]

I love this, awesome!! Thank you very very much for this wonderful contribution! Also, the idea of using "" to get all the letters is great, I hadn't thought of that! Thank you!

[Lartu]

Merged! Please @dvkt go ahead and document this new funcion in the GitBook and - if possible - go ahead and regenerate the man page for LDPL (instructions for doing that are in the /man folder).

[xvxx]

Done! https://docs.ldpl-lang.org/text-statements/split-by-in

[Lartu]

Awesome! I see you also documented INCR and DECR, thank you very much! This is so great, haha, thank you!