BinaryToFloat (String function): Difference between revisions
m (1 revision) |
m (first pass, match syntax diagram to template and fix tags) |
||
Line 1: | Line 1: | ||
{{Template:String:BinaryToFloat subtitle}} | {{Template:String:BinaryToFloat subtitle}} | ||
<var>BinaryToFloat</var> is an [[Intrinsic classes|intrinsic]] function converts a binary string representation of a floating point number to that number. | |||
==Syntax== | ==Syntax== | ||
{{Template:String:BinaryToFloat syntax}} | {{Template:String:BinaryToFloat syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>% | <tr><th>%number</th> | ||
<td>A numeric variable to receive the float value of the | <td>A numeric variable to receive the float value of the method object <var class="term">string</var>.</td></tr> | ||
<tr><th>string</th> | <tr><th><var class="term">string</var></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> | ||
==Usage notes== | ==Usage notes== | ||
<ul><li><var>BinaryToFloat</var> is available as of <var class="product">Sirius Mods</var> version 7.5.</ul> | |||
==Examples== | ==Examples== | ||
<ol><li>The following program demonstrates the <var>BinaryToFloat</var> method, converting a series of different-length representations of the same float value. The example also uses:<ul> | |||
The following program demonstrates the <var>BinaryToFloat</var> method, | <li>the <var>[[Right (String function)|Right]]</var> method. | ||
converting a series of different-length representations of the same float value. | <li>the <var>[[Substring (String function)|Substring]]</var> method. | ||
<li>the <var>[[PrintText statement|PrintText]]</var> statement.</ul> | |||
The example also uses: | |||
<p class="code">begin | <p class="code">begin | ||
image silly | image silly | ||
Line 46: | Line 41: | ||
end for | end for | ||
end | end | ||
</p> | </p> | ||
The result is: | The result is: | ||
Line 84: | Line 78: | ||
%s:substring(5, 8):binaryTo<var>Float</var> = 3.3 | %s:substring(5, 8):binaryTo<var>Float</var> = 3.3 | ||
%s:substring(13, 16):binaryTo<var>Float</var> = 3.3 | %s:substring(13, 16):binaryTo<var>Float</var> = 3.3 | ||
</p></ol> | |||
==See also== | ==See also== | ||
<ul><li>The inverse of the <var>BinaryToFloat</var> method is <var>[[FloatToBinary (Float function)|FloatToBinary]]</var>.</ul> | |||
{{Template:String:BinaryToFloat footer}} | {{Template:String:BinaryToFloat footer}} |
Revision as of 03:50, 31 January 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
- 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
- The inverse of the BinaryToFloat method is FloatToBinary.