<doc>

<legacy_id></legacy_id>

<name>byteToNum</name>

<type>function</type>

<syntax>

<example>the byteToNum of <i>byte</i></example>

<example>byteToNum(<i>byte</i>)</example>

</syntax>

<synonyms>

</synonyms>

<summary>Returns the numeric value of a byte.</summary>

<examples>

<example>byteToNum(byte 1 of tString)</example>

<example>if byteToNum(nextByte) = 0 then next repeat</example>

<example><p>numToByte(byteToNum(&quot;Z&quot;)) <i><a name="code tag=">-- returns Z</a></i></p></example>

</examples>

<history>

<introduced version="4.0">Added.</introduced>

<deprecated version=""></deprecated>

<removed version=""></removed>

<changed version=""></changed>

</history>

<objects>

</objects>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<classification>

<category>Text and Data Processing</category>

</classification>

<references>

<function tag="charToNum">charToNum Function</function>

<function tag="numToChar">numToChar Function</function>

<function tag="numToByte">numToByte Function</function>

<function tag="md5Digest">md5Digest Function</function>

</references>

<description>

<overview>Converts a single byte to a numeric value in the range 0-255</overview>

<parameters>

<parameter>The <i>byte</i> is any <a name="glossary tag=expression">expression</a> that evaluates to a byte. If you specify a <a name="keyword tag=string">string</a> containing more than one byte, all bytes but the first are ignored.</parameter>

</parameters>

<value>The <b>byteToNum</b> <control_st tag="function">function</control_st> returns an <keyword tag="integer">integer</keyword> between zero and 255.</value>

<comments>The <b>byteToNum</b> function is the inverse of the <function tag="numToByte">numToByte</function> function.</comments>

</description>

</doc>