MD5digest (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (first pass, match syntax diagram to template and fix tags)
Line 1: Line 1:
{{Template:String:MD5digest subtitle}}
{{Template:String:MD5digest subtitle}}


This [[Intrinsic classes|intrinsic]] function returns the 16-byte (always) binary string that is the
<var>MD5digest</var> function is an [[Intrinsic classes|intrinsic]] function that returns the 16-byte (always) binary string that is the MD5 digest (hash) of the method object <var class="term">string</var>.
MD5 digest (hash) of the method object string.


The <var>MD5digest</var> function is available as of version 7.3 of the <var class=product>Sirius Mods</var>.
==Syntax==
==Syntax==
{{Template:String:MD5digest syntax}}
{{Template:String:MD5digest syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%outStr</th>
<tr><th>%string</th>
<td>A string variable to receive the MD5 digest of the method object string.                         </td></tr>
<td>A string variable to receive the MD5 digest of the method object <var class="term">string</var>.</td></tr>
<tr><th>string</th>
<tr><th><var class="term">string</var></th>
<td>The string to which the method is applied.</td></tr>
<td>The string to which the method is applied.</td></tr>
</table>
</table>


==Usage notes==
==Usage notes==
*MD5 (Message-Digest algorithm 5) is a well-known cryptographic hashing function which is used in the '''''Janus Network Security''''' product for digital signatures. A complete explanation of MD5 hashing can easily be found on the Internet.
<ul><li>MD5 (Message-Digest algorithm 5) is a well-known cryptographic hashing function which is used in the <var class="product">Janus Network Security</var> product for digital signatures. A complete explanation of MD5 hashing can easily be found on the Internet.
*<var>MD5digest</var> is available for use by '''''Janus SOAP''''' or '''''Janus Network Security''''' customers.
<li><var>MD5digest</var> is available for use by <var class="product">Janus Soap</var> or <var class="product">Janus Network Security</var> customers.
*[[SHAdigest (String function)|SHAdigest]] returns the SHA digest of the method object string, and RC4encrypt (:hdref refid=strc4ed.) returns the RC4 encryption of the method object string.
<li>The 16-byte MD5 hash of a string is typically expressed as a 32-digit hex value.
<li><var>MD5digest</var> is available as of <var class="product">Sirius Mods</var> version 7.3.</ul>
 
==Examples==
==Examples==
 
<ol><li>In the following example, the output string from the <var>MD5digest</var> method is converted to hex using the <var>[[StringToHex (String function)|StringToHex]]</var> intrinsic method:
The 16-byte MD5 hash of a string is typically expressed as a 32-digit hex value.
<p class="code">printText {'this is a test':md5digest:stringtohex}
In the following example, the output string from the <var>MD5digest</var> method is converted to hex using the
[[StringToHex (String function)|StringToHex]] intrinsic method:
<p class="code">[[Intrinsic classes#printtext|printText]] {'this is a test':md5digest:stringtohex}
 
</p>
</p>
The result (displayed on two lines) is:
The result is:
<p class="output">'this is a test':md5digest:stringtohex is 9034E10B7993EB846B6D127070E71E25
<p class="output">'this is a test':md5digest:stringtohex is 9034E10B7993EB846B6D127070E71E25
</p></ol>


</p>
==See also==
==See also==
<ul><li><var>[[SHAdigest (String function)|SHAdigest]]</var> returns the SHA digest of the method object string, and <var>[[RC4encrypt (String function)|RC4encrypt]]</var> returns the RC4 encryption of the method object string.
<li>For details of the <var>printtext</var> statement, please see [[Intrinsic classes#printtext|printText]]</ul>
{{Template:String:MD5digest footer}}
{{Template:String:MD5digest footer}}

Revision as of 07:09, 31 January 2011

16-byte MD5 digest (String class)


MD5digest function is an intrinsic function that returns the 16-byte (always) binary string that is the MD5 digest (hash) of the method object string.

Syntax

%outString = string:MD5digest

Syntax terms

%string A string variable to receive the MD5 digest of the method object string.
string The string to which the method is applied.

Usage notes

  • MD5 (Message-Digest algorithm 5) is a well-known cryptographic hashing function which is used in the Janus Network Security product for digital signatures. A complete explanation of MD5 hashing can easily be found on the Internet.
  • MD5digest is available for use by Janus Soap or Janus Network Security customers.
  • The 16-byte MD5 hash of a string is typically expressed as a 32-digit hex value.
  • MD5digest is available as of Sirius Mods version 7.3.

Examples

  1. In the following example, the output string from the MD5digest method is converted to hex using the StringToHex intrinsic method:

    printText {'this is a test':md5digest:stringtohex}

    The result is:

    'this is a test':md5digest:stringtohex is 9034E10B7993EB846B6D127070E71E25

See also

  • SHAdigest returns the SHA digest of the method object string, and RC4encrypt returns the RC4 encryption of the method object string.
  • For details of the printtext statement, please see printText