<doc>
  <legacy_id>2445</legacy_id>
  <name>md5Digest</name>
  <type>function</type>
  <syntax>
    <example>the md5Digest of <i>dataString</i></example>
    <example>md5Digest(<i>dataString</i>)</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Text and Data Processing</category>
  </classification>
  <references>
    <function tag="base64Decode">base64Decode Function</function>
    <function tag="base64Encode">base64Encode Function</function>
    <function tag="charToNum">charToNum Function</function>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary><glossary tag="return">Returns</glossary> a 128-<glossary tag="bit">bit</glossary> <function tag="value">value</function> based on a <keyword tag="string">string</keyword>.</summary>
  <examples>
    <example>md5Digest("ABC")</example>
    <example>set the savedPrint of field 1 to the md5Digest of field 1</example>
    <example>if the savedPrint of field 1 is not the md5Digest of field 1 then beep</example>
  </examples>
  <description>
    <p>Use the <b>md5Digest</b> <control_st tag="function">function</control_st> to create a fingerprint of the <i>dataString</i> which can be checked later to ensure that the <keyword tag="string">string</keyword> has not changed.</p><p/><p><b>Parameters:</b></p><p>The <i>dataString</i> is any <keyword tag="string">string</keyword>, or an <glossary tag="expression">expression</glossary> that <glossary tag="evaluate">evaluates</glossary> to a <keyword tag="string">string</keyword>.</p><p/><p><b>Value:</b></p><p>The <b>md5Digest</b> <control_st tag="function">function</control_st> <glossary tag="return">returns</glossary> a 128-<glossary tag="bit">bit</glossary> value. (If you view this <function tag="value">value</function> as a <keyword tag="string">string</keyword>, it is 16 <keyword tag="characters">characters</keyword> long.)</p><p/><p><b>Comments:</b></p><p>The value returned for one <i>dataString</i> is mathematically unlikely to be identical to the value <glossary tag="return">returned</glossary> for an altered version of the <i>dataString</i>. Therefore, you can check the <b>md5Digest</b> of a <keyword tag="string">string</keyword> against a saved <b>md5Digest</b> to determine whether the <keyword tag="string">string</keyword> has changed since you saved the <function tag="value">value</function>.</p><p/><p>For technical information about the MD-5 digest algorithm, see RFC 1321 at &lt;<u>http://www.ietf.org/rfc/rfc1321.txt</u>&gt;.</p>
  </description>
</doc>