home contribute faq download

FunctX XQuery Functions

functx:insert-string

Inserts a string at a specified position

Google
Webxqueryfunctions.com

Description

The functx:insert-string function inserts a string ($stringToInsert) into another string ($originalString) at a specified position (which is 1-based). If the position is greater than the length of $originalString, it concatenates $stringToInsert at the end.

Arguments and Return Type

NameTypeDescription
$originalString xs:string? the original string to insert into
$stringToInsert xs:string? the string to insert
$pos xs:integer the position
return value xs:string

XQuery Function Declaration

See XSLT definition.
declare namespace functx = "http://www.functx.com";
declare function functx:insert-string
  ( $originalString as xs:string? ,
    $stringToInsert as xs:string? ,
    $pos as xs:integer )  as xs:string {

   concat(substring($originalString,1,$pos - 1),
             $stringToInsert,
             substring($originalString,$pos))
 } ;

Examples

XQuery ExampleResults
functx:insert-string('xyz','def',2)
xdefyz
functx:insert-string('xyz','def',5)
xyzdef
functx:insert-string('xyz','',2)
xyz
functx:insert-string('','def',2)
def

See Also

functx:index-of-stringThe position(s) of a substring

History

Published OnLast UpdatedContributor(s)
2006-06-272007-02-26Priscilla Walmsley, Datypic, pwalmsley@datypic.com, http://www.datypic.com
Datypic XQuery Services

Recommended Reading:

XQuery