view docs/ccguide/l3tol.refentry @ 588:e70529a05aca os9l1phoenix

Cleanup for Phoenix Release
author boisy
date Mon, 04 Nov 2002 22:28:30 +0000 (2002-11-04)
parents b3caab86dff9
children 986ff3d9f814
line wrap: on
line source
<refentry id="l3tol">
<refnamediv>
<refname>L3tol</refname>
<refname>Ltol3</refname>
<refpurpose>convet between long integers and 3-byte integers</refpurpose>
</refnamediv>

<refsynopsisdiv>
<funcsynopsis>
<funcprototype>
  <funcdef><function>l3tol</function></funcdef>
  <paramdef>long *<parameter>lp</parameter></paramdef>
  <paramdef>char *<parameter>cp</parameter></paramdef>
  <paramdef>int <parameter>n</parameter></paramdef>
</funcprototype>

<funcprototype>
  <funcdef><function>ltol3</function></funcdef>
  <paramdef>char *<parameter>cp</parameter></paramdef>
  <paramdef>long *<parameter>lp</parameter></paramdef>
  <paramdef>int <parameter>n</parameter></paramdef>
</funcprototype>
</funcsynopsis>

</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
Certain system values, such as disc addresses, are maintained
in three-byte form rather than four-byte; these functions
enable arithmetic to be used on them.
</para>
<para>
L3tol converts a vector on "n" three-byte integers pointed to
by "cp", into a vector of long integers starting at "lp".
</para>
<para>
Ltol3 does the opposite.
</para>
</refsect1>
</refentry>