---
name: "RtlLargeIntegerToChar"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/RtlLargeIntegerToChar"
---

# RtlLargeIntegerToChar(3w)

## NAME

**RtlLargeIntegerToChar** (NTDLL.@)

## SYNOPSIS

NTSTATUS RtlLargeIntegerToChar\
  (\
   const ULONGLONG\* *value\_ptr*,\
   ULONG            *base*,\
   ULONG            *length*,\
   PCHAR            *str*\
  )

## PARAMS

*value\_ptr* **\[In\]**  Pointer to the value to be converted.

*base* **\[In\]**  Number *base* for conversion (allowed **0**,2,8,10 or **16**).

*length* **\[In\]**  Length of the *str* buffer in bytes.

*str* **\[Out\]**  Destination for the converted value.

## DESCRIPTION

Convert an unsigned large integer to a character string.

## RETURNS

**Success:** **STATUS\_SUCCESS**. *str* contains the converted number

**Failure:** **STATUS\_INVALID\_PARAMETER**, if *base* is not **0**, **2**, **8**, **10** or **16.** **STATUS\_BUFFER\_OVERFLOW**, if *str* would be larger than *length*. **STATUS\_ACCESS\_VIOLATION**, if *str* is **NULL**.

## NOTES

Instead of *base* **0** it uses **10** as *base*. Writes at most *length* characters to the string *str*. Str is **' '** terminated when *length* allows it. When *str* fits exactly in *length* characters the **' '** is omitted. If *value\_ptr* is **NULL** it crashes, as the native function does.

## DIFFERENCES

**-** Accept *base* **0** as **10** instead of crashing as native function does.

**-** The native function does produce garbage or **STATUS\_BUFFER\_OVERFLOW** for *base* **2**, **8** and **16** when the value is larger than 0xFFFFFFFF.

## IMPLEMENTATION

Declared in **"winternl.h"**.

Implemented in **"dlls/ntdll/large\_int.c"**.