Conversion Functions

The following functions have been superseded by the Binary Functions and by standard functions of XQuery 4.0:

Conventions

Binary Data

Removed: convert:binary-to-string, convert:string-to-base64, convert:string-to-hex (use the Binary Functions instead).

convert:integers-to-base64

convert:integers-to-base64(  $input  as xs:integer*) as xs:base64Binary

convert:integers-to-base64(Q{java:java.lang.String}get-bytes('abc'))

convert:integers-to-hex

convert:integers-to-hex(  $input  as xs:integer*) as xs:hexBinary

convert:binary-to-integers

convert:binary-to-integers(  $value  as (xs:base64Binary|xs:hexBinary)) as xs:integer*

convert:binary-to-integers(xs:hexBinary('FF'))

convert:binary-to-bytes

convert:binary-to-bytes(  $value  as (xs:base64Binary|xs:hexBinary)) as xs:byte*

convert:binary-to-bytes(xs:base64Binary('QmFzZVggaXMgY29vbA=='))

convert:binary-to-bytes(xs:hexBinary("4261736558"))

Number

convert:integer-to-base

convert:integer-to-base(  $value  as xs:integer,  $base   as xs:integer) as xs:string

convert:integer-to-base(-1, 16)

convert:integer-to-base(22, 5)

convert:integer-from-base

convert:integer-from-base(  $value  as xs:string,  $base   as xs:integer) as xs:integer

convert:integer-from-base('ffffffffffffffff', 16)

convert:integer-from-base('CAFEBABE', 16)

convert:integer-from-base('42', 5)

convert:integer-from-base(convert:integer-to-base(123, 7), 7)

Dates and Durations

Removed: convert:integer-to-dayTime, convert:dayTime-to-integer (use fn:seconds instead).

convert:integer-to-dateTime

convert:integer-to-dateTime(  $value  as xs:integer) as xs:dateTimeStamp

convert:integer-to-dateTime(0)

convert:integer-to-dateTime(1234567890123)

convert:integer-to-dateTime(prof:current-ms())

convert:dateTime-to-integer

convert:dateTime-to-integer(  $value  as xs:dateTime) as xs:integer

convert:dateTime-to-integer(xs:dateTime('1970-01-01T00:00:00Z'))

convert:dateTime-to-integer(xs:dateTime('292278994-08-17T07:12:55Z'))

Keys

• If lax conversion is disabled, a string is encoded to a valid NCName representation:
  • An empty string is converted to a single underscore (_).
  • Existing underscores are rewritten to two underscores (__).
  • Characters that are not valid NCName characters are rewritten to an underscore and the character’s four-digit Unicode. For example, the exclamation mark ! is transformed to _0021.
• With lax conversion enabled, invalid characters are replaced with underscores or (when invalid as first character of an element name) prefixed with an underscore. The resulting string may be better readable, but it cannot necessarily be converted back to the original form.

convert:encode-key

convert:encode-key(  $key  as xs:string,  $lax  as xs:boolean?  := false()) as xs:string

element { convert:encode-key("!") } { }

convert:decode-key

convert:decode-key(  $key  as xs:string,  $lax  as xs:boolean?  := false()) as xs:string

convert:decode-key(name(<_0021/>))

json:doc("doc.json")//* ! convert:decode-key(name())

Errors

Changelog

• Removed: convert:binary-to-string, convert:string-to-base64, convert:string-to-hex in favor of Binary Functions.
• Removed: convert:integer-to-dayTime, convert:dayTime-to-integer in favor of fn:seconds.

• Added: convert:encode-key, convert:decode-key.

• Added: convert:binary-to-integers.
• Updated: convert:integers-to-base64, convert:integers-to-hex: Renamed from convert:bytes-to-base64; argument type relaxed from xs:byte to xs:integer.
• Updated: error codes updated; errors now use the module namespace

• Updated: convert:binary-to-string: $fallback argument added.

• Added: convert:integer-to-dateTime, convert:dateTime-to-integer, convert:integer-to-dayTime, convert:dayTime-to-integer.

• Added: New module added. Some of the functions have been adopted from the obsolete Utility Functions.