BinaryToFloat (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (first pass, match syntax diagram to template and fix tags)
m (re-match syntax diagram to revised template; fix tags. Still some link targets that need to be found / written.)
Line 9: Line 9:
<tr><th>%number</th>
<tr><th>%number</th>
<td>A numeric variable to receive the float value of the method object <var class="term">string</var>.</td></tr>
<td>A numeric variable to receive the float value of the method object <var class="term">string</var>.</td></tr>
<tr><th><var class="term">string</var></th>
<tr><th>string</th>
<td>A binary string value that can have a length of 4, 8, or 16 bytes.</td></tr>
<td>A binary string value that can have a length of 4, 8, or 16 bytes.</td></tr>
</table>
</table>
Line 45: Line 45:
<p class="output">-3.3:
<p class="output">-3.3:
%s:stringToHex = C134CCCDC134CCCCCCCCCCCCC134CCCCCCCCCCCC0000000000000000
%s:stringToHex = C134CCCDC134CCCCCCCCCCCCC134CCCCCCCCCCCC0000000000000000
%s:substring(1, 4):binaryTo<var>Float</var> = -3.30000019073486
%s:substring(1, 4):binaryToFloat = -3.30000019073486
%s:substring(5, 8):binaryTo<var>Float</var> = -3.3
%s:substring(5, 8):binaryToFloat = -3.3
%s:substring(13, 16):binaryTo<var>Float</var> = -3.3
%s:substring(13, 16):binaryToFloat = -3.3
-2.2:
-2.2:
%s:stringToHex = C1233333C123333333333333C1233333333333330000000000000000
%s:stringToHex = C1233333C123333333333333C1233333333333330000000000000000
%s:substring(1, 4):binaryTo<var>Float</var> = -2.19999980926514
%s:substring(1, 4):binaryToFloat = -2.19999980926514
%s:substring(5, 8):binaryTo<var>Float</var> = -2.2
%s:substring(5, 8):binaryToFloat = -2.2
%s:substring(13, 16):binaryTo<var>Float</var> = -2.2
%s:substring(13, 16):binaryToFloat = -2.2
-1.1:
-1.1:
%s:stringToHex = C111999AC111999999999999C1119999999999990000000000000000
%s:stringToHex = C111999AC111999999999999C1119999999999990000000000000000
%s:substring(1, 4):binaryTo<var>Float</var> = -1.10000038146973
%s:substring(1, 4):binaryToFloat = -1.10000038146973
%s:substring(5, 8):binaryTo<var>Float</var> = -1.1
%s:substring(5, 8):binaryToFloat = -1.1
%s:substring(13, 16):binaryTo<var>Float</var> = -1.1
%s:substring(13, 16):binaryToFloat = -1.1
   0:
   0:
%s:stringToHex = 00000000000000000000000000000000000000000000000000000000
%s:stringToHex = 00000000000000000000000000000000000000000000000000000000
%s:substring(1, 4):binaryTo<var>Float</var> = 0
%s:substring(1, 4):binaryToFloat = 0
%s:substring(5, 8):binaryTo<var>Float</var> = 0
%s:substring(5, 8):binaryToFloat = 0
%s:substring(13, 16):binaryTo<var>Float</var> = 0
%s:substring(13, 16):binaryToFloat = 0
  1.1:
  1.1:
%s:stringToHex = 4111999A411199999999999941119999999999990000000000000000
%s:stringToHex = 4111999A411199999999999941119999999999990000000000000000
%s:substring(1, 4):binaryTo<var>Float</var> = 1.10000038146973
%s:substring(1, 4):binaryToFloat = 1.10000038146973
%s:substring(5, 8):binaryTo<var>Float</var> = 1.1
%s:substring(5, 8):binaryToFloat = 1.1
%s:substring(13, 16):binaryTo<var>Float</var> = 1.1
%s:substring(13, 16):binaryToFloat = 1.1
  2.2:
  2.2:
%s:stringToHex = 41233333412333333333333341233333333333330000000000000000
%s:stringToHex = 41233333412333333333333341233333333333330000000000000000
%s:substring(1, 4):binaryTo<var>Float</var> = 2.19999980926514
%s:substring(1, 4):binaryToFloat = 2.19999980926514
%s:substring(5, 8):binaryTo<var>Float</var> = 2.2
%s:substring(5, 8):binaryToFloat = 2.2
%s:substring(13, 16):binaryTo<var>Float</var> = 2.2
%s:substring(13, 16):binaryToFloat = 2.2
  3.3:
  3.3:
%s:stringToHex = 4134CCCD4134CCCCCCCCCCCC4134CCCCCCCCCCCC0000000000000000
%s:stringToHex = 4134CCCD4134CCCCCCCCCCCC4134CCCCCCCCCCCC0000000000000000
%s:substring(1, 4):binaryTo<var>Float</var> = 3.30000019073486
%s:substring(1, 4):binaryToFloat = 3.30000019073486
%s:substring(5, 8):binaryTo<var>Float</var> = 3.3
%s:substring(5, 8):binaryToFloat = 3.3
%s:substring(13, 16):binaryTo<var>Float</var> = 3.3
%s:substring(13, 16):binaryToFloat = 3.3
</p></ol>
</p></ol>



Revision as of 02:13, 2 February 2011

Convert binary string representation of a number to floating point (String class)


BinaryToFloat is an intrinsic function converts a binary string representation of a floating point number to that number.

Syntax

%number = string:BinaryToFloat

Syntax terms

%number A numeric variable to receive the float value of the method object string.
string A binary string value that can have a length of 4, 8, or 16 bytes.

Usage notes

  • BinaryToFloat is available as of Sirius Mods version 7.5.

Examples

  1. The following program demonstrates the BinaryToFloat method, converting a series of different-length representations of the same float value. The example also uses:

    begin image silly a is float len 4 b is float len 8 c is float len 16 end image prepare image silly %i is float %s is string len 30 for %i from -3.3 to 3.3 by 1.1 printText {%i:right(15)}: %silly:a = %i; %silly:b = %i; %silly:c = %i; %s = $lstr_get_image('SILLY') printText {~} = {%s:stringToHex} printText {~} = {%s:substring(1, 4):binaryToFloat} printText {~} = {%s:substring(5, 8):binaryToFloat} printText {~} = {%s:substring(13, 16):binaryToFloat} end for end

    The result is:

    -3.3: %s:stringToHex = C134CCCDC134CCCCCCCCCCCCC134CCCCCCCCCCCC0000000000000000 %s:substring(1, 4):binaryToFloat = -3.30000019073486 %s:substring(5, 8):binaryToFloat = -3.3 %s:substring(13, 16):binaryToFloat = -3.3 -2.2: %s:stringToHex = C1233333C123333333333333C1233333333333330000000000000000 %s:substring(1, 4):binaryToFloat = -2.19999980926514 %s:substring(5, 8):binaryToFloat = -2.2 %s:substring(13, 16):binaryToFloat = -2.2 -1.1: %s:stringToHex = C111999AC111999999999999C1119999999999990000000000000000 %s:substring(1, 4):binaryToFloat = -1.10000038146973 %s:substring(5, 8):binaryToFloat = -1.1 %s:substring(13, 16):binaryToFloat = -1.1 0: %s:stringToHex = 00000000000000000000000000000000000000000000000000000000 %s:substring(1, 4):binaryToFloat = 0 %s:substring(5, 8):binaryToFloat = 0 %s:substring(13, 16):binaryToFloat = 0 1.1: %s:stringToHex = 4111999A411199999999999941119999999999990000000000000000 %s:substring(1, 4):binaryToFloat = 1.10000038146973 %s:substring(5, 8):binaryToFloat = 1.1 %s:substring(13, 16):binaryToFloat = 1.1 2.2: %s:stringToHex = 41233333412333333333333341233333333333330000000000000000 %s:substring(1, 4):binaryToFloat = 2.19999980926514 %s:substring(5, 8):binaryToFloat = 2.2 %s:substring(13, 16):binaryToFloat = 2.2 3.3: %s:stringToHex = 4134CCCD4134CCCCCCCCCCCC4134CCCCCCCCCCCC0000000000000000 %s:substring(1, 4):binaryToFloat = 3.30000019073486 %s:substring(5, 8):binaryToFloat = 3.3 %s:substring(13, 16):binaryToFloat = 3.3

See also