FunctX XQuery Functions

FunctX XQuery Function Library > Numbers > Formatting >

functx:pad-integer-to-length

Pads an integer to a desired length by adding leading zeros

Description

The functx:pad-integer-to-length function returns $integerToPad concatenated with enough leading zeros to make its length $length. The function will raise an error if $integerToPad is longer than $length.

Arguments and Return Type

Name	Type	Description
`$integerToPad`	`xs:anyAtomicType?`	the integer to pad
`$length`	`xs:integer`	the desired length
return value	`xs:string`

XQuery Function Declaration

See XSLT definition.

declare namespace functx = "http://www.functx.com";
declare function functx:pad-integer-to-length
  ( $integerToPad as xs:anyAtomicType? ,
    $length as xs:integer )  as xs:string {

   if ($length < string-length(string($integerToPad)))
   then error(xs:QName('functx:Integer_Longer_Than_Length'))
   else concat
         (functx:repeat-string(
            '0',$length - string-length(string($integerToPad))),
          string($integerToPad))
 } ;