FunctX XSLT Function Library > Sequences > Manipulating >

fn:insert-before

Inserts a new item into a sequence

Description

The fn:insert-before function returns a copy of the $target sequence with the item(s) in $inserts inserted at the position indicated by $position. Position numbers start at 1, not 0.

This description is © Copyright 2007, Priscilla Walmsley. It is excerpted from the book XQuery by Priscilla Walmsley, O'Reilly, 2007. For a complete explanation of this function, please refer to Appendix A of the book.

Arguments and Return Type

Examples

insert-before(
   ('a', 'b', 'c'), 1, ('x', 'y'))

('x', 'y', 'a', 'b', 'c')

insert-before(
   ('a', 'b', 'c'), 2, ('x', 'y'))

('a', 'x', 'y', 'b', 'c')

insert-before(
   ('a', 'b', 'c'), 10, ('x', 'y'))

('a', 'b', 'c', 'x', 'y')

insert-before(
   ('a', 'b', 'c'), 0, ('x', 'y'))

('x', 'y', 'a', 'b', 'c')

insert-before(
   ('a', 'b', 'c'), 2, ())

('a', 'b', 'c')

insert-before(
   (), 3, ('a', 'b', 'c') )

('a', 'b', 'c')

History