Changes

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/>All errors are assigned to the <code><nowiki>http://basex.org/errors</nowiki></code> namespace, which is statically bound to the {{Code|bxerr}} prefix.

|Converts the specifed binary data {{Code|$bytes}} ({{Code|xs:base64Binary}}, {{Code|xs:hexBinary}}) to a string:

|{{Error|BXCO0001string|#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.

|{{Func|convert:string-to-base64|$input string as xs:string|xs:base64Binary}}<br/>{{Func|convert:string-to-base64|$input string as xs:string, $encoding as xs:string|xs:base64Binary}}

|Converts the specified {{Code|$string }} to a an {{Code|xs:base64Binary}} item. If the default encoding is chosen, conversion will be cheap, as both {{Code|xs:string}} strings and {{Code|xs:base64Binary}} items binaries are both internally represented as byte arrays.<br/>The UTF-8 default encoding can be overwritten with the optional {{Code|$encoding}} argument.

|{{Error|BXCO0001binary|#Errors}} The input cannot be represented in the specified encoding.<br/>{{Error|BXCO0002encoding|#Errors}} The specified encoding is invalid or not supported.

|{{Func|convert:string-to-hex|$input string as xs:string|xs:hexBinary}}<br/>{{Func|convert:string-to-hex|$input string as xs:string, $encoding as xs:string|xs:hexBinary}}

|Converts the specified {{Code|$string }} to a an {{Code|xs:hexBinary}} item. If the default encoding is chosen, conversion will be cheap, as both {{Code|xs:string}} strings and {{Code|xs:hexBinary}} items binaries are both internally represented as byte arrays.<br/>The UTF-8 default encoding can be overwritten with the optional {{Code|$encoding}} argument.

|{{Error|BXCO0001binary|#Errors}} The input cannot be represented in the specified encoding.<br/>{{Error|BXCO0002encoding|#Errors}} The specified encoding is invalid or not supported.

==convert:bytesintegers-to-base64==

{| width='100%'|-| width='120' | '''Signatures'''|{{MarkFunc|Updated with Version 8.7convert:integers-to-base64|$integers as xs:integer*|xs:base64Binary}}: Argument type relaxed from |-| '''Summary'''|Converts the specified {{Code|xs:byte$integers}} to an item of type {{Code|xs:integerbase64Binary}}:* 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==

|{{Func|convert:bytesintegers-to-base64hex|$input integers as xs:integer*|xs:base64BinaryhexBinary}}

|Converts the specified integer sequence {{Code|$integers}} to a an item of type {{Code|xs:base64BinaryhexBinary}} item:* Only the first 8 bits of the supplied integers will be considered. * Conversion of byte sequences is particularly cheap, as {{Code|xs:base64Binary}} items of binary type are internally represented as byte arrays.|-| '''Errors'''|{{Error|BXCO0001|#Errors}} The input cannot be represented in the specified encoding.<br/>{{Error|BXCO0002|#Errors}} The specified encoding is invalid or not supported.

==convert:bytesbinary-to-hexintegers== {{Mark|Updated with Version 8.7}}: Argument type relaxed from {{Code|xs:byte}} to {{Code|xs:integer}}.

|{{Func|convert:bytesbinary-to-hexinteger|$input binary as xs:integer*anyAtomicType|xs:hexBinaryinteger*}}

|Converts Returns the specified integer sequence to a {{Code|$binary}} ({{Code|xs:hexBinarybase64Binary}} item. Conversion of byte sequences is particularly cheap, as {{Code|xs:hexBinary}} items are internally represented ) as byte arraysa sequence of unsigned integers (octets).|-| '''Examples'''|* <code>convert:binary-to-integer(xs:hexBinary('FF'))</code> yields {{Code|255}}.

|{{Func|convert:binary-to-bytes|$bin binary as xs:anyAtomicType|xs:byte*}}

|Returns the specified {{Code|$binary data }} ({{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.

|{{Func|convert:integer-to-base|$num number as xs:integer, $base as xs:integer|xs:string}}<br />

|Converts {{Code|$numnumber}} to base a string, using the specified {{Code|$base}}, interpreting it as a 64-bit unsigned integer.<br />The first {{Code|$base}} elements of the sequence {{Code|'0',..,'9','a',..,'z'}} are used as digits.<br />Valid bases are {{Code|2, .., 36}}.<br />

|{{Error|BXCO0004base|#Errors}} The specified base is not in the range 2-36.

|{{Func|convert:integer-from-base|$str string as xs:string, $base as xs:integer|xs:integer}}<br />

|Decodes an {{Code|xs:integer}} from {{Code|$strstring}}, assuming that it's encoded in base using the specified {{Code|$base}}.<br /> The first {{Code|$base}} elements of the sequence {{Code|'0',..,'9','a',..,'z'}} are allowed as digits, ; case doesn't does not matter. <br />Valid bases are 2 - 36.<br /> If {{Code|$str}} the supplied string contains more than 64 bits of information, the result is will be truncated arbitarily.

|{{Error|BXCO0004base|#Errors}} The specified base is not in the range 2-36.<br/>{{Error|BXCO0005integer|#Errors}} The specified digit is not valid for the given range.

|{{Func|convert:integer-to-dateTime|$ms milliseconds as xs:integer|xs:dateTime}}<br />

|Converts the specified number of {{Code|$milliseconds }} since 1 Jan 1970 to an item of type xs:dateTime.<br />

|Converts the specified {{Code|$dateTime}} item of type xs:dateTime to the number of milliseconds since 1 Jan 1970.<br />

|{{Func|convert:integer-to-dayTime|$ms milliseconds as xs:integer|xs:dayTimeDuration}}<br />

|Converts the specified number of {{Code|$milliseconds }} to an item of type xs:dayTimeDuration.<br />

|Converts the specified item of type xs:dayTimeDuration {{Code|$dayTime}} duration to milliseconds represented by an integer.<br />

|{{Code|BXCO0001base}}|The input specified base is an invalid XML string, or not in the wrong encoding has been specified.|range 2-|{{Code|BXCO0002}}|The specified encoding is invalid or not supported36.

|{{Code|BXCO0003binary}}|The specified base is not in the range 2-36input cannot be converted to a binary representation.

|{{Code|BXCO0004encoding}}

|{{Code|BXCO0005integer}}

;Version 8.7 * Updated: [[#convert:bytes-to-base64|convert:bytes-to-base64]], [[#convert:bytes-to-hex|convert:bytes-to-hex]]: Argument type relaxed from {{Code|xs:byte}} to {{Code|xs:integer}}9.0