Design

Back Next

concat

The concat function in XQuery is used to concatenate two or more strings into a single string. This function allows you to effectively combine multiple string values into one continuous string.

Syntax

fn:concat(arg1, arg2)

The following table describes the argument for this command:

Argument	Required/Optional	Description
arg1	Required	The first value to concatenate.
arg2	Required	The second value to concatenate.

Return Value

Returns a single

xs:string

composed of the concatenated string representations of the provided arguments.

If any of the arguments is the empty sequence, the argument is treated as the zero-length string.

Examples

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
fn:concat('a')	Error XPST0017
fn:concat('a', 'b')	ab
fn:concat('a', 'b', 'c')	abc
fn:concat('a', (), 'b', '', 'c')	abc
fn:concat( ('a', 'b', 'c') )	Error XPST0017
fn:concat('a', <x>b</x>, 'c')	abc
fn:concat("Hello, ", "World", "!")	"Hello, World!"
fn:concat("Result: ", 42)	"Result: 42"
fn:concat("Start-", (), "End")	"Start-End"