home contribute faq download

FunctX XQuery Functions

functx:replace-beginning

Replaces the beginning of a string, up to a matched pattern

Google
Webxqueryfunctions.com

Description

The functx:replace-beginning function replaces the beginning of $arg (up to and including the first area that matches $pattern) with $replacement. If no area matches the pattern, no replacement is made.

Arguments and Return Type

NameTypeDescription
$arg xs:string? the entire string to change
$pattern xs:string the pattern of characters to replace up to
$replacement xs:string the replacement string
return value xs:string

XQuery Function Declaration

See XSLT definition.
declare namespace functx = "http://www.functx.com";
declare function functx:replace-beginning
  ( $arg as xs:string? ,
    $pattern as xs:string ,
    $replacement as xs:string )  as xs:string {

   replace($arg, concat('^.*?', $pattern), $replacement)
 } ;

Examples

XQuery ExampleResults
functx:replace-beginning('abc-def', '-', 'xxx')
xxxdef
functx:replace-beginning('abc-def', '-', '')
def
functx:replace-beginning(
   '---abc', '[a-z]', 'x')
xbc
functx:replace-beginning(
     '2004-12-05', '-', '2005-')
2005-12-05

See Also

functx:replace-firstReplaces the first match of a pattern
fn:replaceReplaces parts of a string that match a regular expression

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