_join

Combine a list of Text values together -- Function

LIST -> _join(OPEN, SEP, CLOSE) -> QTEXT

_join takes the given LIST, and turns it into a single line. For example, if My List was "Cat", "Dog", "Horse", then

My List -> _join

would come out as "CatDogHorse".

Of course, that probably isn't what you want -- most of the time, you want some separators at the beginning, middle and end. Those are the parameters; how many parameters you give define how they are used. If there is only one, then it is SEP, the separator in between elements. So

My List -> _join("", "")

would come out as "Cat, Dog, Horse" -- more reasonable.

If there are two parameters, then they are OPEN and SEP. So for example, if I wanted to include dashes at the beginning, that would be:

My List -> _join(""-- "", "", "")

which would come out as "-- Cat, Dog, Horse". And if I wanted parentheses around the entire list, I'd use all three parameters -- OPEN, SEP and CLOSE -- as:

My List -> _join(""("", "", "", "")"")

to get "(Cat, Dog, Horse)".

Note that you can use _join with anything, not just Text -- if the received values aren't Text, then they will be rendered into their default forms before getting combined. But at the end of _join, what you get back is one big block of QText. You can't do any further processing on the elements after this.