Click above to get retro games delivered to your door ever month!

 V_DECRYPT()
 Decrypt a variable that has been encrypted with V_ENCRYPT()
-------------------------------------------------------------------------------

 Syntax

    V_DECRYPT( <cEncrypted_string> )   ->    cOriginal

 Arguments

    <cEncrypted_string> is a variable previously encrypted with
    the V_ENCRYPT() function.

 Returns

    V_DECRYPT() returns a string as it was before a call to V_ENCRYPT().

 Description

    V_DECRYPT() will decrypt a string that has been previously encrypted
    with the V_ENCRYPT() function.  The string will only be decrypted
    properly if the V_SETKEY() function has been called with the same key
    that was in effect when the V_ENCRYPT() originally scrambled the
    <cEncrypted_string>.

 Examples

    LOCAL cSecure, cOriginal

    // Set the key to my dog's name.
    V_SETKEY( "Tally" )

    // Encrypt a character string.  Store the result in <cSecure>.
    cSecure = V_ENCRYPT( "Just try to decode <cSecure> without my dog." )

    // Later, decode the secured string with the help of my golden.
    // The call to V_SETKEY() is redundant because the program has not
    // terminated and it has not been set to a different V_SETKEY().
    V_SETKEY( "Tally" )
    cOriginal = V_DECRYPT( cSecure )