.\" -*- nroff -*- .\" Generated file - DO NOT EDIT! .TH _i64tow 3w "Oct 2012" "Wine API" "Wine API" .SH NAME \fB_i64tow\fR (NTDLL.@) .SH SYNOPSIS LPWSTR _i64tow ( LONGLONG \fIvalue\fR, LPWSTR \fIstr\fR, INT \fIradix\fR ) .SH PARAMS \fIvalue\fR \fB[In]\fR Value to be converted. .PP \fIstr\fR \fB[Out]\fR Destination for the converted \fIvalue\fR. .PP \fIradix\fR \fB[In]\fR Number base for conversion. .PP .SH DESCRIPTION .PP Converts a large integer to a unicode string. .SH RETURNS .PP Always returns \fIstr\fR. .SH NOTES .PP Converts \fIvalue\fR to a \fB'\0'\fR terminated wstring which is copied to \fIstr\fR. The maximum length of the copied \fIstr\fR is \fB33\fR bytes. If \fIradix\fR is \fB10\fR and \fIvalue\fR is negative, the \fIvalue\fR is converted with sign. Does not check if \fIradix\fR is in the range of \fB2\fR to \fB36.\fR If \fIstr\fR is \fBNULL\fR it just returns \fBNULL\fR. .SH DIFFERENCES .PP \fB-\fR The native dll converts negative values (for base \fB10\fR) wrong: .PP \fB-\fR\fB1\fR is converted to \fB-18446744073709551615\fR .PP \fB-\fR\fB2\fR is converted to \fB-18446744073709551614\fR .PP \fB-\fR\fB9223372036854775807\fR is converted to \fB-9223372036854775809\fR .PP \fB-\fR\fB9223372036854775808\fR is converted to \fB-9223372036854775808\fR The native msvcrt _i64tow function and our ntdll function do not have this bug. .SH IMPLEMENTATION .PP Declared in \fB"msvcrt/stdlib.h"\fR. .PP Implemented in \fB"dlls/ntdll/wcstring.c"\fR.