Difference between revisions of "Conversion Module"
Jump to navigation
Jump to search
(42 intermediate revisions by 3 users not shown) | |||
Line 3: | Line 3: | ||
=Conventions= | =Conventions= | ||
− | All functions in this module are assigned to the | + | {{Mark|Updated with Version 9.0:}} |
− | + | ||
+ | All functions and errors in this module are assigned to the <code><nowiki>http://basex.org/modules/convert</nowiki></code> namespace, which is statically bound to the {{Code|convert}} prefix.<br/> | ||
=Strings= | =Strings= | ||
==convert:binary-to-string== | ==convert:binary-to-string== | ||
+ | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert:binary-to-string|$bytes as | + | |{{Func|convert:binary-to-string|$bytes as xs:anyAtomicType|xs:string}}<br/>{{Func|convert:binary-to-string|$bytes as xs:anyAtomicType, $encoding as xs:string|xs:string}}<br/>{{Func|convert:binary-to-string|$bytes as xs:anyAtomicType, $encoding as xs:string, $fallback as xs:boolean|xs:string}} |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts the specifed | + | |Converts the specifed {{Code|$bytes}} ({{Code|xs:base64Binary}}, {{Code|xs:hexBinary}}) to a string: |
+ | * The UTF-8 default encoding can be overwritten with the optional {{Code|$encoding}} argument. | ||
+ | * By default, invalid characters will be rejected. If {{Code|$fallback}} is set to true, these characters will be replaced with the Unicode replacement character <code>FFFD</code> (�). | ||
|- | |- | ||
| '''Errors''' | | '''Errors''' | ||
− | |{{Error| | + | |{{Error|string|#Errors}} The input is an invalid XML string, or the wrong encoding has been specified.<br/>{{Error|BXCO0002|#Errors}} The specified encoding is invalid or not supported. |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:binary-to-string(xs:hexBinary('48656c6c6f576f726c64'))}} | + | * {{Code|convert:binary-to-string(xs:hexBinary('48656c6c6f576f726c64'))}} yields {{Code|HelloWorld}}. |
|} | |} | ||
==convert:string-to-base64== | ==convert:string-to-base64== | ||
+ | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert:string-to-base64|$ | + | |{{Func|convert:string-to-base64|$string as xs:string|xs:base64Binary}}<br/>{{Func|convert:string-to-base64|$string as xs:string, $encoding as xs:string|xs:base64Binary}} |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts the specified string to | + | |Converts the specified {{Code|$string}} to an {{Code|xs:base64Binary}} item. If the default encoding is chosen, conversion will be cheap, as strings and binaries are both internally represented as byte arrays.<br/>The UTF-8 default encoding can be overwritten with the optional {{Code|$encoding}} argument. |
|- | |- | ||
| '''Errors''' | | '''Errors''' | ||
− | |{{Error| | + | |{{Error|binary|#Errors}} The input cannot be represented in the specified encoding.<br/>{{Error|encoding|#Errors}} The specified encoding is invalid or not supported. |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:string-to-base64('HelloWorld')}} | + | * {{Code|string(convert:string-to-base64('HelloWorld'))}} yields <code>SGVsbG9Xb3JsZA==</code>. |
|} | |} | ||
==convert:string-to-hex== | ==convert:string-to-hex== | ||
+ | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert:string-to-hex|$ | + | |{{Func|convert:string-to-hex|$string as xs:string|xs:hexBinary}}<br/>{{Func|convert:string-to-hex|$string as xs:string, $encoding as xs:string|xs:hexBinary}} |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts the specified string to | + | |Converts the specified {{Code|$string}} to an {{Code|xs:hexBinary}} item. If the default encoding is chosen, conversion will be cheap, as strings and binaries are both internally represented as byte arrays.<br/>The UTF-8 default encoding can be overwritten with the optional {{Code|$encoding}} argument. |
|- | |- | ||
| '''Errors''' | | '''Errors''' | ||
− | |{{Error| | + | |{{Error|binary|#Errors}} The input cannot be represented in the specified encoding.<br/>{{Error|encoding|#Errors}} The specified encoding is invalid or not supported. |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:string-to-hex('HelloWorld')}} | + | * {{Code|string(convert:string-to-hex('HelloWorld'))}} yields {{Code|48656C6C6F576F726C64}}. |
|} | |} | ||
=Binary Data= | =Binary Data= | ||
− | ==convert: | + | ==convert:integers-to-base64== |
+ | |||
+ | {{Mark|Updated with Version 9.0:}} Renamed from {{Code|convert:bytes-to-base64}}; argument type relaxed from {{Code|xs:byte}} to {{Code|xs:integer}}. | ||
+ | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert: | + | |{{Func|convert:integers-to-base64|$integers as xs:integer*|xs:base64Binary}} |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts the specified | + | |Converts the specified {{Code|$integers}} to an item of type {{Code|xs:base64Binary}}: |
+ | * Only the first 8 bits of the supplied integers will be considered. | ||
+ | * Conversion of byte sequences is particularly cheap, as items of binary type are internally represented as byte arrays. | ||
+ | |} | ||
+ | |||
+ | ==convert:integers-to-hex== | ||
+ | |||
+ | {{Mark|Updated with Version 9.0:}} Renamed from {{Code|convert:bytes-to-base64}}; argument type relaxed from {{Code|xs:byte}} to {{Code|xs:integer}}. | ||
+ | |||
+ | {| width='100%' | ||
|- | |- | ||
− | | ''' | + | | width='120' | '''Signatures''' |
− | |{{ | + | |{{Func|convert:integers-to-hex|$integers as xs:integer*|xs:hexBinary}} |
|- | |- | ||
− | | ''' | + | | '''Summary''' |
− | | | + | |Converts the specified {{Code|$integers}} to an item of type {{Code|xs:hexBinary}}: |
− | + | * Only the first 8 bits of the supplied integers will be considered. | |
+ | * Conversion of byte sequences is particularly cheap, as items of binary type are internally represented as byte arrays. | ||
|} | |} | ||
− | ==convert: | + | ==convert:binary-to-integers== |
+ | |||
+ | {{Mark|Introduced with Version 9.0:}} | ||
+ | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert: | + | |{{Func|convert:binary-to-integer|$binary as xs:anyAtomicType|xs:integer*}} |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | | | + | |Returns the specified {{Code|$binary}} ({{Code|xs:base64Binary}}, {{Code|xs:hexBinary}}) as a sequence of unsigned integers (octets). |
− | |||
− | |||
− | |||
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * | + | * <code>convert:binary-to-integer(xs:hexBinary('FF'))</code> yields {{Code|255}}. |
|} | |} | ||
==convert:binary-to-bytes== | ==convert:binary-to-bytes== | ||
+ | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert:binary-to-bytes|$ | + | |{{Func|convert:binary-to-bytes|$binary as xs:anyAtomicType|xs:byte*}} |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Returns the specified binary | + | |Returns the specified {{Code|$binary}} ({{Code|xs:base64Binary}}, {{Code|xs:hexBinary}}) as a sequence of bytes. The conversion is very cheap and takes no additional memory, as items of binary type are internally represented as byte arrays. |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * <code>convert:binary-to-bytes(xs:base64Binary('QmFzZVggaXMgY29vbA=='))</code> | + | * <code>convert:binary-to-bytes(xs:base64Binary('QmFzZVggaXMgY29vbA=='))</code> yields the sequence {{Code|(66, 97, 115, 101, 88, 32, 105, 115, 32, 99, 111, 111, 108)}}. |
− | * {{Code|convert:binary-to-bytes(xs:hexBinary("4261736558"))}} | + | * {{Code|convert:binary-to-bytes(xs:hexBinary("4261736558"))}} yields the sequence {{Code|(66 97 115 101 88)}}. |
|} | |} | ||
Line 113: | Line 133: | ||
==convert:integer-to-base== | ==convert:integer-to-base== | ||
+ | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert:integer-to-base|$ | + | |{{Func|convert:integer-to-base|$number as xs:integer, $base as xs:integer|xs:string}}<br /> |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts {{Code|$ | + | |Converts {{Code|$number}} to a string, using the specified {{Code|$base}}, interpreting it as a 64-bit unsigned integer.<br />The first base elements of the sequence {{Code|'0',..,'9','a',..,'z'}} are used as digits.<br />Valid bases are {{Code|2, .., 36}}.<br /> |
+ | |- | ||
+ | | '''Errors''' | ||
+ | |{{Error|base|#Errors}} The specified base is not in the range 2-36. | ||
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:integer-to-base(-1, 16)}} | + | * {{Code|convert:integer-to-base(-1, 16)}} yields {{Code|'ffffffffffffffff'}}. |
− | * {{Code|convert:integer-to-base(22, 5)}} | + | * {{Code|convert:integer-to-base(22, 5)}} yields {{Code|'42'}}. |
|} | |} | ||
==convert:integer-from-base== | ==convert:integer-from-base== | ||
+ | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert:integer-from-base|$ | + | |{{Func|convert:integer-from-base|$string as xs:string, $base as xs:integer|xs:integer}}<br /> |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Decodes an | + | |Decodes an integer from {{Code|$string}}, using the specified {{Code|$base}}.<br /> The first base elements of the sequence {{Code|'0',..,'9','a',..,'z'}} are allowed as digits; case does not matter. <br />Valid bases are 2 - 36.<br /> If the supplied string contains more than 64 bits of information, the result will be truncated. |
+ | |- | ||
+ | | '''Errors''' | ||
+ | |{{Error|base|#Errors}} The specified base is not in the range 2-36.<br/>{{Error|integer|#Errors}} The specified digit is not valid for the given range. | ||
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:integer-from-base('ffffffffffffffff', 16)}} | + | * {{Code|convert:integer-from-base('ffffffffffffffff', 16)}} yields {{Code|-1}}. |
− | * {{Code|convert:integer-from-base('CAFEBABE', 16)}} | + | * {{Code|convert:integer-from-base('CAFEBABE', 16)}} yields {{Code|3405691582}}. |
− | * {{Code|convert:integer-from-base('42', 5)}} | + | * {{Code|convert:integer-from-base('42', 5)}} yields {{Code|22}}. |
− | * {{Code|convert:integer-from-base(convert:integer-to-base(123, 7), 7)}} | + | * {{Code|convert:integer-from-base(convert:integer-to-base(123, 7), 7)}} yields {{Code|123}}. |
|} | |} | ||
Line 148: | Line 176: | ||
==convert:integer-to-dateTime== | ==convert:integer-to-dateTime== | ||
− | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert:integer-to-dateTime|$ | + | |{{Func|convert:integer-to-dateTime|$milliseconds as xs:integer|xs:dateTime}}<br /> |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts the specified number of milliseconds since 1 Jan 1970 to an item of type xs:dateTime.<br /> | + | |Converts the specified number of {{Code|$milliseconds}} since 1 Jan 1970 to an item of type xs:dateTime.<br /> |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:integer-to-dateTime(0)}} | + | * {{Code|convert:integer-to-dateTime(0)}} yields {{Code|1970-01-01T00:00:00Z}}. |
− | * {{Code|convert:integer-to-dateTime(1234567890123)}} | + | * {{Code|convert:integer-to-dateTime(1234567890123)}} yields {{Code|2009-02-13T23:31:30.123Z}}. |
+ | * {{Code|convert:integer-to-dateTime(prof:current-ms())}} returns the current miliseconds in the {{Code|xs:dateTime}} format. | ||
|} | |} | ||
==convert:dateTime-to-integer== | ==convert:dateTime-to-integer== | ||
− | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
|{{Func|convert:dateTime-to-integer|$dateTime as xs:dateTime|xs:integer}}<br /> | |{{Func|convert:dateTime-to-integer|$dateTime as xs:dateTime|xs:integer}}<br /> | ||
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts the specified item | + | |Converts the specified {{Code|$dateTime}} item to the number of milliseconds since 1 Jan 1970.<br /> |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:dateTime-to-integer(xs:dateTime('1970-01-01T00:00:00Z'))}} | + | * {{Code|convert:dateTime-to-integer(xs:dateTime('1970-01-01T00:00:00Z'))}} yields {{Code|0}}. |
|} | |} | ||
==convert:integer-to-dayTime== | ==convert:integer-to-dayTime== | ||
− | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
− | |{{Func|convert:integer-to-dayTime|$ | + | |{{Func|convert:integer-to-dayTime|$milliseconds as xs:integer|xs:dayTimeDuration}}<br /> |
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts the specified number of milliseconds to an item of type xs:dayTimeDuration.<br /> | + | |Converts the specified number of {{Code|$milliseconds}} to an item of type xs:dayTimeDuration.<br /> |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:integer-to-dayTime(1234)}} | + | * {{Code|convert:integer-to-dayTime(1234)}} yields {{Code|PT1.234S}}. |
|} | |} | ||
==convert:dayTime-to-integer== | ==convert:dayTime-to-integer== | ||
− | |||
{| width='100%' | {| width='100%' | ||
|- | |- | ||
− | | width=' | + | | width='120' | '''Signatures''' |
|{{Func|convert:dayTime-to-integer|$dayTime as xs:dayTimeDuration|xs:integer}}<br /> | |{{Func|convert:dayTime-to-integer|$dayTime as xs:dayTimeDuration|xs:integer}}<br /> | ||
|- | |- | ||
| '''Summary''' | | '''Summary''' | ||
− | |Converts the specified | + | |Converts the specified {{Code|$dayTime}} duration to milliseconds represented by an integer.<br /> |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
| | | | ||
− | * {{Code|convert:dayTime-to-integer(xs:dayTimeDuration('PT1S'))}} | + | * {{Code|convert:dayTime-to-integer(xs:dayTimeDuration('PT1S'))}} yields {{Code|1000}}. |
|} | |} | ||
=Errors= | =Errors= | ||
− | {| | + | {{Mark|Updated with Version 9.0:}} |
− | ! width=" | + | |
− | + | {| class="wikitable" width="100%" | |
+ | ! width="110"|Code | ||
+ | | Description | ||
+ | |- | ||
+ | |{{Code|base}} | ||
+ | |The specified base is not in the range 2-36. | ||
|- | |- | ||
− | |{{Code| | + | |{{Code|binary}} |
− | |The input | + | |The input cannot be converted to a binary representation. |
|- | |- | ||
− | |{{Code| | + | |{{Code|encoding}} |
|The specified encoding is invalid or not supported. | |The specified encoding is invalid or not supported. | ||
+ | |- | ||
+ | |{{Code|integer}} | ||
+ | |The specified digit is not valid for the given range. | ||
+ | |- | ||
+ | |{{Code|string}} | ||
+ | |The input is an invalid XML string, or the wrong encoding has been specified. | ||
|} | |} | ||
=Changelog= | =Changelog= | ||
+ | |||
+ | ;Version 9.0 | ||
+ | |||
+ | * Added: [[#convert:binary-to-integers|convert:binary-to-integers]]. | ||
+ | * Updated: [[#convert:integers-to-base64|convert:integers-to-base64]], [[#convert:integers-to-hex|convert:integers-to-hex]]: Renamed from {{Code|convert:bytes-to-base64}}; argument type relaxed from {{Code|xs:byte}} to {{Code|xs:integer}}. | ||
+ | * Updated: error codes updated; errors now use the module namespace | ||
+ | |||
+ | ;Version 8.5 | ||
+ | |||
+ | * Updated: [[#convert:binary-to-string|convert:binary-to-string]]: <code>$fallback</code> argument added. | ||
;Version 7.5 | ;Version 7.5 | ||
− | * Added: | + | * Added: [[#convert:integer-to-dateTime|convert:integer-to-dateTime]], [[#convert:dateTime-to-integer|convert:dateTime-to-integer]], [[#convert:integer-to-dayTime|convert:integer-to-dayTime]], [[#convert:dayTime-to-integer|convert:dayTime-to-integer]]. |
The module was introduced with Version 7.3. Some of the functions have been adopted from the obsolete Utility Module. | The module was introduced with Version 7.3. Some of the functions have been adopted from the obsolete Utility Module. | ||
− | |||
− |
Revision as of 17:45, 23 November 2017
This XQuery Module contains functions to convert data between different formats.
Conventions
All functions and errors in this module are assigned to the http://basex.org/modules/convert
namespace, which is statically bound to the convert
prefix.
Strings
convert:binary-to-string
Signatures | convert:binary-to-string($bytes as xs:anyAtomicType) as xs:string convert:binary-to-string($bytes as xs:anyAtomicType, $encoding as xs:string) as xs:string convert:binary-to-string($bytes as xs:anyAtomicType, $encoding as xs:string, $fallback as xs:boolean) as xs:string
|
Summary | Converts the specifed $bytes (xs:base64Binary , xs:hexBinary ) to a string:
|
Errors | string : The input is an invalid XML string, or the wrong encoding has been specified.BXCO0002 : The specified encoding is invalid or not supported.
|
Examples |
|
convert:string-to-base64
Signatures | convert:string-to-base64($string as xs:string) as xs:base64Binary convert:string-to-base64($string as xs:string, $encoding as xs:string) as xs:base64Binary
|
Summary | Converts the specified $string to an xs:base64Binary item. If the default encoding is chosen, conversion will be cheap, as strings and binaries are both internally represented as byte arrays.The UTF-8 default encoding can be overwritten with the optional $encoding argument.
|
Errors | binary : The input cannot be represented in the specified encoding.encoding : The specified encoding is invalid or not supported.
|
Examples |
|
convert:string-to-hex
Signatures | convert:string-to-hex($string as xs:string) as xs:hexBinary convert:string-to-hex($string as xs:string, $encoding as xs:string) as xs:hexBinary
|
Summary | Converts the specified $string to an xs:hexBinary item. If the default encoding is chosen, conversion will be cheap, as strings and binaries are both internally represented as byte arrays.The UTF-8 default encoding can be overwritten with the optional $encoding argument.
|
Errors | binary : The input cannot be represented in the specified encoding.encoding : The specified encoding is invalid or not supported.
|
Examples |
|
Binary Data
convert:integers-to-base64
Template:Mark Renamed from convert:bytes-to-base64
; argument type relaxed from xs:byte
to xs:integer
.
Signatures | convert:integers-to-base64($integers as xs:integer*) as xs:base64Binary
|
Summary | Converts the specified $integers to an item of type xs:base64Binary :
|
convert:integers-to-hex
Template:Mark Renamed from convert:bytes-to-base64
; argument type relaxed from xs:byte
to xs:integer
.
Signatures | convert:integers-to-hex($integers as xs:integer*) as xs:hexBinary
|
Summary | Converts the specified $integers to an item of type xs:hexBinary :
|
convert:binary-to-integers
Signatures | convert:binary-to-integer($binary as xs:anyAtomicType) as xs:integer*
|
Summary | Returns the specified $binary (xs:base64Binary , xs:hexBinary ) as a sequence of unsigned integers (octets).
|
Examples |
|
convert:binary-to-bytes
Signatures | convert:binary-to-bytes($binary as xs:anyAtomicType) as xs:byte*
|
Summary | Returns the specified $binary (xs:base64Binary , xs:hexBinary ) as a sequence of bytes. The conversion is very cheap and takes no additional memory, as items of binary type are internally represented as byte arrays.
|
Examples |
|
Numbers
convert:integer-to-base
Signatures | convert:integer-to-base($number as xs:integer, $base as xs:integer) as xs:string |
Summary | Converts $number to a string, using the specified $base , interpreting it as a 64-bit unsigned integer.The first base elements of the sequence '0',..,'9','a',..,'z' are used as digits.Valid bases are 2, .., 36 . |
Errors | base : The specified base is not in the range 2-36.
|
Examples |
|
convert:integer-from-base
Signatures | convert:integer-from-base($string as xs:string, $base as xs:integer) as xs:integer |
Summary | Decodes an integer from $string , using the specified $base .The first base elements of the sequence '0',..,'9','a',..,'z' are allowed as digits; case does not matter. Valid bases are 2 - 36. If the supplied string contains more than 64 bits of information, the result will be truncated. |
Errors | base : The specified base is not in the range 2-36.integer : The specified digit is not valid for the given range.
|
Examples |
|
Dates and Durations
convert:integer-to-dateTime
Signatures | convert:integer-to-dateTime($milliseconds as xs:integer) as xs:dateTime |
Summary | Converts the specified number of $milliseconds since 1 Jan 1970 to an item of type xs:dateTime. |
Examples |
|
convert:dateTime-to-integer
Signatures | convert:dateTime-to-integer($dateTime as xs:dateTime) as xs:integer |
Summary | Converts the specified $dateTime item to the number of milliseconds since 1 Jan 1970. |
Examples |
|
convert:integer-to-dayTime
Signatures | convert:integer-to-dayTime($milliseconds as xs:integer) as xs:dayTimeDuration |
Summary | Converts the specified number of $milliseconds to an item of type xs:dayTimeDuration. |
Examples |
|
convert:dayTime-to-integer
Signatures | convert:dayTime-to-integer($dayTime as xs:dayTimeDuration) as xs:integer |
Summary | Converts the specified $dayTime duration to milliseconds represented by an integer. |
Examples |
|
Errors
Code | Description |
---|---|
base
|
The specified base is not in the range 2-36. |
binary
|
The input cannot be converted to a binary representation. |
encoding
|
The specified encoding is invalid or not supported. |
integer
|
The specified digit is not valid for the given range. |
string
|
The input is an invalid XML string, or the wrong encoding has been specified. |
Changelog
- Version 9.0
- Added: convert:binary-to-integers.
- Updated: convert:integers-to-base64, convert:integers-to-hex: Renamed from
convert:bytes-to-base64
; argument type relaxed fromxs:byte
toxs:integer
. - Updated: error codes updated; errors now use the module namespace
- Version 8.5
- Updated: convert:binary-to-string:
$fallback
argument added.
- Version 7.5
- Added: convert:integer-to-dateTime, convert:dateTime-to-integer, convert:integer-to-dayTime, convert:dayTime-to-integer.
The module was introduced with Version 7.3. Some of the functions have been adopted from the obsolete Utility Module.