NAME¶

RtlCharToInteger (NTDLL.@)

SYNOPSIS¶

NTSTATUS RtlCharToInteger
(
PCSZ str,
ULONG base,
ULONG* value
)

PARAMS¶

str [In] ' ' terminated single-byte string containing a number. base [In] Number base for conversion (allowed 0,2,8,10 or 16). value [Out] Destination for the converted value.

DESCRIPTION¶

Converts a character string into its integer equivalent.

RETURNS¶

Success: STATUS_SUCCESS. value contains the converted number Failure: STATUS_INVALID_PARAMETER, if base is not 0, 2, 8, 10 or 16. STATUS_ACCESS_VIOLATION, if value is NULL.

NOTES¶

For base 0 it uses 10 as base and the string should be in the format "{whitespace} [+|-] [0[x|o|b]] {digits}". For other bases the string should be in the format "{whitespace} [+|-] {digits}". No check is made for value overflow, only the lower 32 bits are assigned. If str is NULL it crashes, as the native function does.

DIFFERENCES¶

This function does not read garbage behind ' ' as the native version does.

IMPLEMENTATION¶

Declared in "winternl.h". Implemented in "dlls/ntdll/rtlstr.c". Debug channel "ntdll".