Hash
Script function world.Hash Read about scripting Type Method Summary Produces a hash (checksum) of a specified piece of text Prototype `BSTR Hash(BSTR Text);` View list of data type meanings Description `This produces a 160-bit hash of the supplied text, returned as a 40-character hex string (40 X 4 bits = 160 bits). eg. world.note world.hash ("This Mud is running on the Dawn Codebase") c6a948fc8e81baa172a15aa534409b7654861a33 You might use this to store a hash of a long string (eg. a script file) to see if it has changed rather than storing the text itself. There is no limit to the length of the string that can be hashed. Because of the way strings are stored this will not work with strings which have nulls in them (hex 00), however see below for a work-around for Lua.` VBscript example
    world.note world.hash ("This Mud is running on the Dawn Codebase")
Jscript example
    world.note (world.hash ("This Mud is running on the Dawn Codebase"));
PerlScript example
    $world->note ($world->hash ("This Mud is running on the Dawn Codebase"));
Python example
    world.note (world.hash ("This Mud is running on the Dawn Codebase"))
Lua example
    Note (Hash("This Mud is running on the Dawn Codebase"))
Lua notes
    In MUSHclient version 3.57 onwards you can also use

    hashed_string = utils.hash (s)

    This works the same as described above, however it will correctly handle strings with the null (hex 00) character in them.
Return value
    A 40-character hexadecimal string which is the hash of the supplied text.
See Also ... Topics Scripting Utilities Functions Base64Decode (Takes a base-64 encoded string and decodes it.) Base64Encode (Encodes a string using base-64 encoding.) ChangeDir (Changes the MUSHclient working directory) CreateGUID (Creates a GUID - Global Unique Identifier) EditDistance (Returns the Levenshtein Edit Distance between two words) ErrorDesc (Converts a MUSHclient script error code into an human-readable description) ExportXML (Exports a world item in XML format) FixupEscapeSequences (Converts "escape sequences" like &#x5C;t to their equivalent codes.) FixupHTML (Fixes up text for writing as HTML) GenerateName (Generates a random character name) GetClipboard (Gets the clipboard contents) GetScriptTime (Returns the amount of time spent in script routines) GetUniqueID (Creates a unique ID for general use, or for making Plugin IDs) GetUniqueNumber (Returns a unique number) Help (Shows help for a script function, or a list of functions) ImportXML (Imports configuration data in XML format) Metaphone (Returns the metaphone code for the supplied word) MtRand (Returns pseudo-random number using the Mersenne Twister algorithm) MtSrand (Seed the Mersenne Twister pseudo-random number generator) ReadNamesFile (Loads in a file for generating character names) Replace (Replaces one substring with another) SetClipboard (Sets the clipboard contents) SetStatus (Sets the status line text) Simulate (Simulate input from the MUD, for debugging purposes) Sound (Plays a sound) StripANSI (Strips ANSI colour sequences from a string) Trace (Trace mode property) TraceOut (Outputs the supplied message to the world Trace) TranslateGerman (Translate German umluat sequences) Transparency (Sets the transparency of the main MUSHclient window under Windows XP) Trim (Trims leading and trailing spaces from a string) (Help topic: function=Hash) Documentation contents page