Virtual Devices (3.1) (vdag31qh.hlp) (Table of Contents; Topic list)
Convert_Decimal_String
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     edx, OFFSET32 String        ; points to decimal string
VMMcall Convert_Decimal_String
 
mov     [Value], eax                ; decimal value of string
mov     [TermChar], edx             ; points to terminating character
 
The Convert_Decimal_String service converts a string representing a decimal
number into a value. The service also returns a pointer to the character in
the string that marked the end of the decimal number.
 
This service is only valid during initialization.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
String     Points to the null-terminated string to convert. The string can
           be any combination of decimal digits and may preceded by a plus
           sign (+) or minus sign (-) to indicate a positive or negative
           value.
 
Return Value
 
The EAX register contains the value of decimal string, and the EDX register
contains the address of the character in the string that terminated the
decimal value.
 
Comments
 
If the string is empty or does not contain a valid decimal integer,
Convert_Decimal_String returns zero, and the EDX register continues to point
to the first character in the string.
 
Uses
 
EAX, EDX, Flags
 
See Also
 
Convert_Boolean_String, Convert_Fixed_Point_String, Convert_Hex_String