Method SecureKey():toString()

Converts the binary key to a hexadecimal notation.

 
:toString([<cBin>], [<cSeparator>], [<nGroup>]) --> cHexString

<cBin>

The key in binary form. If the parameter is not passed, the current key of the instance is used.

Optionally, a separator can be placed between groups of characters to make the string more easy to read. It must be a printable character but not a character used by hexadecimal notation, such as 0..9/A..F. By default, no separating characters are placed into the result.

This parameter determines the number of characters between the separation character. The default value is 2. <nGroup> must be a numeric value greater than 1 and less than or equal to len(<cBin>/2).

Returns a character string. The returned string is longer than the binary representation of the key, depending on <cSeparator> and <nGroup>.

The method :toString() can be used to return a key in hexadecimal notation. Passing a cipher key to the designated user of the key is done easier if the key can be passed in written formats rather than in electronic formats only. To create a key using the hexadecimal notation, use :toBin().

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.

Method SecureKey():toString() Professional