String method


Prototype

String Proto lValue:LONG, lpszBuffer:LPSTR, lType:LONG

Syntax

Invoke String, lValue, lpszBuffer, lType

Function

Converts a numerical value to a null-terminated string.

Parameters

lValue

Numerical value to be converted.

lpszBuffer

Pointer to a buffer to receive the converted value.

lType

Type of conversion. It can be one of the following values:

0 ecBinary Converts the numerical value to a binary string value
1 ecDecimal Converts the numerical value to a decimal string value
2 ecHexa Converts the numerical value to a hexa decimal string value
3 ecOctal Converts the numerical value to an octal string value

Return value

Eax/Rax returns the number of characters placed in the buffer excluding the terminating null character.


NOTE: When the method returns, the last character in the buffer is an 'H' for hexadecimal conversions, a 'B' for binary conversions, or an 'O' for octal conversions.

REMARKS: The String method will fill the buffer pointed by lpszBuffer with a Unicode string if the application is running as Unicode, or with an ANSI string if not (see the IsAppUnicode method). You can call StringA to get ANSI strings in Unicode applications, or StringW to get Unicode strings in ANSI applications.