$D2C: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
mNo edit summary
Line 2: Line 2:
<span class="pageSubtitle"><section begin="desc" />Binary byte representation of integer<section end="desc" /></span>
<span class="pageSubtitle"><section begin="desc" />Binary byte representation of integer<section end="desc" /></span>


<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $D2C function is [[to be entered]].</p>
<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $D2C function is the [[FloatToString (Float function)]].  For a full list of string and numeric conversion functions see [[List of String methods]] and [[List of Float methods]].</p>


The $D2C function returns a byte string which is the binary equivalent of an integer.  
The $D2C function returns a byte string which is the binary equivalent of an integer.  
Line 13: Line 13:


The returned result is a byte string representing, in binary, the integer part of argument one. If argument two is omitted, the result has as many bytes needed to represent (the non-negative) argument one. Otherwise, the result is sign-extended to as many bytes as specified in argument two, or truncated. A null string is returned for invalid arguments.
The returned result is a byte string representing, in binary, the integer part of argument one. If argument two is omitted, the result has as many bytes needed to represent (the non-negative) argument one. Otherwise, the result is sign-extended to as many bytes as specified in argument two, or truncated. A null string is returned for invalid arguments.
==Syntax==
==Syntax==
<p class="syntax"><section begin="syntax" /> %RESULT = $D2C(int_val, width)
<p class="syntax"><section begin="syntax" /> %RESULT = $D2C(int_val, width)
Line 20: Line 21:
<p class="caption">%RESULT is set to the width-char binary byte representation of int_val.</p>
<p class="caption">%RESULT is set to the width-char binary byte representation of int_val.</p>


The following program will print the value <tt>AB</tt>:


The following program will print the value <tt>AB</tt>:
<p class="code"> B
<p class="code"> B
  PRINT $D2C(256 * $X2D('C1') + $X2D('C2'))
  PRINT $D2C(256 * $X2D('C1') + $X2D('C2'))
  END
  END
</p>
</p>
Here are some other results, with the result shown as the hexadecimal representation of the returned byte string, or as "''" to indicate the null string:
Here are some other results, with the result shown as the hexadecimal representation of the returned byte string, or as "''" to indicate the null string:
<p class="code"> $D2C(9) -> X'09'
<p class="code"> $D2C(9) -> X'09'
  $D2C(129) -> X'81'
  $D2C(129) -> X'81'
Line 39: Line 42:
</p>
</p>


$D2C is similar to the standard $Binary function (described in the ''"Model 204 User Language Manual"''), with some differences, such as being able to specify the output length in bytes rather than bits, and being able to specify results of lengths other than 2 or 4 bytes in length.


$D2C is similar to the standard $BINARY function (described in the ''"Model 204 User Language Manual"''), with some differences, such as being able to specify the output length in bytes rather than bits, and being able to specify results of lengths other than 2 or 4 bytes in length.  
The inverse of $D2C is [[$C2D]]. See also the [[$D2X]] and [[$X2D]] functions and the [[$C2X]] and [[$X2C]] functions (in the ''"Model 204 User Language Manual"'').


The inverse of $D2C is $C2D. See also the $D2X and $X2D functions (in this manual) and the $C2X and $X2C functions (in the ''"Model 204 User Language Manual"'').
<ul class="smallAndTightList">
<ul class="smallAndTightList">
<li>[[Sirius functions]]</li>
<li>[[Sirius functions]]</li>
Line 52: Line 55:
<li>[[Japanese functions]]</li>
<li>[[Japanese functions]]</li>
<li>[[Sir2000 Field Migration Facility]]</li>
<li>[[Sir2000 Field Migration Facility]]</li>
</ul>
</ul>
<p class="caption">Products authorizing $D2C
<p class="caption">Products authorizing $D2C

Revision as of 19:28, 31 January 2011

<section begin="desc" />Binary byte representation of integer<section end="desc" />

Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $D2C function is the FloatToString (Float function). For a full list of string and numeric conversion functions see List of String methods and List of Float methods.

The $D2C function returns a byte string which is the binary equivalent of an integer.

$D2C accepts one required and one optional argument and returns a byte string value.

The first argument is the integer to be converted. If it is omitted, or if after conversion to an integer it is outside the range -2,147,483,647..2,147,483,647, the null string is the result.

The second argument is the number of output bytes in the string. If it is omitted, the first argument must be non-negative, and as many bytes as necessary (1, 2, 3, or 4) are used as the result. If, after conversion to an integer, argument two is not in the range 0..255, the null string is the result.

The returned result is a byte string representing, in binary, the integer part of argument one. If argument two is omitted, the result has as many bytes needed to represent (the non-negative) argument one. Otherwise, the result is sign-extended to as many bytes as specified in argument two, or truncated. A null string is returned for invalid arguments.

Syntax

<section begin="syntax" /> %RESULT = $D2C(int_val, width) <section end="syntax" />

$D2C Function

%RESULT is set to the width-char binary byte representation of int_val.

The following program will print the value AB:

B PRINT $D2C(256 * $X2D('C1') + $X2D('C2')) END

Here are some other results, with the result shown as the hexadecimal representation of the returned byte string, or as "" to indicate the null string:

$D2C(9) -> X'09' $D2C(129) -> X'81' $D2C(129, 1) -> X'81' $D2C(129, 2) -> X'0081' $D2C(257, 1) -> X'01' $D2C(-127, 1) -> X'81' $D2C(-127, 2) -> X'FF81' $D2C(-127) -> $D2C(-1, 4) -> X'FFFFFFFF' $D2C(12, 0) ->

$D2C is similar to the standard $Binary function (described in the "Model 204 User Language Manual"), with some differences, such as being able to specify the output length in bytes rather than bits, and being able to specify results of lengths other than 2 or 4 bytes in length.

The inverse of $D2C is $C2D. See also the $D2X and $X2D functions and the $C2X and $X2C functions (in the "Model 204 User Language Manual").

Products authorizing $D2C

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=$D2C&oldid=28830"