Altova MapForce 2024 Enterprise Edition

Concatenates all the values of the input sequence into one string delimited by whatever string you choose to use as the delimiter. The function returns an empty string if the strings argument is an empty set.

mf-func-string-join

 

Languages

Built-in, C++, C#, Java, XQuery, XSLT 2.0, XSLT 3.0.

 

Parameters

Argument

Description

parent-context

Optional argument. Supplies the parent context. See also Example: Changing the Parent Context.

 

The parent-context argument is an optional argument in some MapForce core aggregation functions (e.g., min, max, avg, count). In a source component which has multiple hierarchical sequences, the parent context determines the set of nodes on which the function should operate.

strings

This argument must be connected to a source item which supplies the actual data. The supplied argument value must be a sequence (zero or many) of xs:string.

delimiter

Optional argument. Specifies the delimiter to be inserted between any two consecutive strings.

 

Example

In the example below, the source XML file contains four Article items, with the following numbers: 1, 2, 3, and 4.

mf_map_string-join

The constant supplies the character "#" as the delimiter. The mapping result is, therefore, 1#2#3#4. If you do not supply a delimiter, then the result becomes 1234.

© 2017-2023 Altova GmbH