5.1.7.106. x2d

Returns the decimal representation of the receiving string, which is a string of hexadecimal characters. If the result cannot be expressed as a whole number, an error results. That is, the result must not have more digits than the current setting of NUMERIC DIGITS.

You can optionally include whitespace characters in the receiving string (at byte boundaries only, not leading or trailing) to improve readability; they are ignored.

If the receiving string is null, the method returns 0.

If you do not specify n, the receiving string is processed as an unsigned binary number.

Example 5.142. String class — x2d method

"0E"~x2d        -->    14
"81"~x2d        -->    129
"F81"~x2d       -->    3969
"FF81"~x2d      -->    65409
"46 30"X~x2d    -->    240          /*  ASCII   */
"66 30"X~x2d    -->    240          /*  ASCII   */

If you specify n, the receiving string is taken as a signed number expressed in n hexadecimal digits. If the leftmost bit is off, then the number is positive; otherwise, it is a negative number. In both cases it is converted to a whole number, which can be negative. If n is 0, the method returns 0.

If necessary, the receiving string is padded on the left with 0 characters (note, not "sign-extended"), or truncated on the left to n characters.

Example 5.143. String class — x2d method

"81"~x2d(2)      -->    -127
"81"~x2d(4)      -->    129
"F081"~x2d(4)    -->    -3967
"F081"~x2d(3)    -->    129
"F081"~x2d(2)    -->    -127
"F081"~x2d(1)    -->    1
"0031"~x2d(0)    -->    0