SHAdigest (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
Line 19: Line 19:


==Examples==
==Examples==
<ol><li>The 20-byte SHA hash of a string is typically expressed as a 40-digit hex value. In the following example, the output string from the <var>SHAdigest</var> method is converted to hex using the [[StringToHex (String function)|StringToHex]] intrinsic method:
The 20-byte SHA hash of a string is typically expressed as a 40-digit hex value. In the following example, the output string from the <var>SHAdigest</var> method is converted to hex using the [[StringToHex (String function)|StringToHex]] intrinsic method:
<p class="output">[[PrintText statement|printText]] {'this is a simple test':shadigest:stringtohex}
<p class="output">[[PrintText statement|printText]] {'this is a simple test':shadigest:stringtohex}
</p>
</p>
The result (displayed on two lines) is:
The result (displayed on two lines) is:
<p class="output">'this is a simple test':shadigest:stringtohex is BC38AA2D6769639946806616C14AF0C69477AABE
<p class="output">'this is a simple test':shadigest:stringtohex is BC38AA2D6769639946806616C14AF0C69477AABE
</p></ol>
</p>


==See also==
==See also==

Revision as of 18:50, 14 March 2012

20-byte SHA digest (String class)


The SHAdigest intrinsic function returns the 20-byte (always) binary string that is the SHA digest of the method object string.

Syntax

%outString = string:SHAdigest

Syntax terms

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

Usage notes

  • SHA (Secure Hash Algorithm) is a set of cryptographic hashing functions; SHAdigest provides SHA-1, the most commonly used. A complete explanation of SHA hashing can easily be found on the internet.
  • SHAdigest is available for use by Janus SOAP or Janus Network Security customers.
  • SHAdigest is available as of Sirius Mods Version 7.3.

Examples

The 20-byte SHA hash of a string is typically expressed as a 40-digit hex value. In the following example, the output string from the SHAdigest method is converted to hex using the StringToHex intrinsic method:

printText {'this is a simple test':shadigest:stringtohex}

The result (displayed on two lines) is:

'this is a simple test':shadigest:stringtohex is BC38AA2D6769639946806616C14AF0C69477AABE

See also

  • MD5digest returns the MD5 digest of the method object string, and
  • RC4encrypt returns the RC4 encryption of the method object string.