4 * Copyright (C) 1996-1998 Marcus Meissner
5 * Copyright (C) 2000 Alexandre Julliard
6 * Copyright (C) 2003 Thomas Mertes
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
34 #include "wine/unicode.h"
35 #include "wine/debug.h"
36 #include "ntdll_misc.h"
38 WINE_DEFAULT_DEBUG_CHANNEL(ntdll
);
40 #define GUID_STRING_LENGTH 38
42 UINT NlsAnsiCodePage
= 0;
43 BYTE NlsMbCodePageTag
= 0;
44 BYTE NlsMbOemCodePageTag
= 0;
46 static const union cptable
*ansi_table
;
47 static const union cptable
*oem_table
;
48 static const union cptable
* unix_table
; /* NULL if UTF8 */
51 /**************************************************************************
52 * __wine_init_codepages (NTDLL.@)
54 * Set the code page once kernel32 is loaded. Should be done differently.
56 void __wine_init_codepages( const union cptable
*ansi
, const union cptable
*oem
,
57 const union cptable
*ucp
)
62 NlsAnsiCodePage
= ansi
->info
.codepage
;
65 int ntdll_umbstowcs(DWORD flags
, const char* src
, int srclen
, WCHAR
* dst
, int dstlen
)
68 wine_cp_mbstowcs( unix_table
, flags
, src
, srclen
, dst
, dstlen
) :
69 wine_utf8_mbstowcs( flags
, src
, srclen
, dst
, dstlen
);
72 int ntdll_wcstoumbs(DWORD flags
, const WCHAR
* src
, int srclen
, char* dst
, int dstlen
,
73 const char* defchar
, int *used
)
76 return wine_cp_wcstombs( unix_table
, flags
, src
, srclen
, dst
, dstlen
, defchar
, used
);
77 if (used
) *used
= 0; /* all chars are valid for UTF-8 */
78 return wine_utf8_wcstombs( src
, srclen
, dst
, dstlen
);
81 /**************************************************************************
82 * RtlInitAnsiString (NTDLL.@)
84 * Initializes a buffered ansi string.
90 * Assigns source to target->Buffer. The length of source is assigned to
91 * target->Length and target->MaximumLength. If source is NULL the length
92 * of source is assumed to be 0.
94 void WINAPI
RtlInitAnsiString(
95 PANSI_STRING target
, /* [I/O] Buffered ansi string to be initialized */
96 PCSZ source
) /* [I] '\0' terminated string used to initialize target */
98 if ((target
->Buffer
= (PCHAR
) source
))
100 target
->Length
= strlen(source
);
101 target
->MaximumLength
= target
->Length
+ 1;
103 else target
->Length
= target
->MaximumLength
= 0;
107 /**************************************************************************
108 * RtlInitString (NTDLL.@)
110 * Initializes a buffered string.
116 * Assigns source to target->Buffer. The length of source is assigned to
117 * target->Length and target->MaximumLength. If source is NULL the length
118 * of source is assumed to be 0.
120 void WINAPI
RtlInitString(
121 PSTRING target
, /* [I/O] Buffered string to be initialized */
122 PCSZ source
) /* [I] '\0' terminated string used to initialize target */
124 RtlInitAnsiString( target
, source
);
128 /**************************************************************************
129 * RtlFreeAnsiString (NTDLL.@)
131 void WINAPI
RtlFreeAnsiString( PSTRING str
)
133 if (str
->Buffer
) RtlFreeHeap( GetProcessHeap(), 0, str
->Buffer
);
137 /**************************************************************************
138 * RtlFreeOemString (NTDLL.@)
140 void WINAPI
RtlFreeOemString( PSTRING str
)
142 RtlFreeAnsiString( str
);
146 /**************************************************************************
147 * RtlCopyString (NTDLL.@)
149 void WINAPI
RtlCopyString( STRING
*dst
, const STRING
*src
)
153 unsigned int len
= min( src
->Length
, dst
->MaximumLength
);
154 memcpy( dst
->Buffer
, src
->Buffer
, len
);
157 else dst
->Length
= 0;
161 /**************************************************************************
162 * RtlInitUnicodeString (NTDLL.@)
164 * Initializes a buffered unicode string.
170 * Assigns source to target->Buffer. The length of source is assigned to
171 * target->Length and target->MaximumLength. If source is NULL the length
172 * of source is assumed to be 0.
174 void WINAPI
RtlInitUnicodeString(
175 PUNICODE_STRING target
, /* [I/O] Buffered unicode string to be initialized */
176 PCWSTR source
) /* [I] '\0' terminated unicode string used to initialize target */
178 if ((target
->Buffer
= (PWSTR
) source
))
180 target
->Length
= strlenW(source
) * sizeof(WCHAR
);
181 target
->MaximumLength
= target
->Length
+ sizeof(WCHAR
);
183 else target
->Length
= target
->MaximumLength
= 0;
187 /**************************************************************************
188 * RtlInitUnicodeStringEx (NTDLL.@)
190 * Initializes a buffered unicode string.
193 * Success: STATUS_SUCCESS. target is initialized.
194 * Failure: STATUS_NAME_TOO_LONG, if the source string is larger than 65532 bytes.
197 * Assigns source to target->Buffer. The length of source is assigned to
198 * target->Length and target->MaximumLength. If source is NULL the length
199 * of source is assumed to be 0.
201 NTSTATUS WINAPI
RtlInitUnicodeStringEx(
202 PUNICODE_STRING target
, /* [I/O] Buffered unicode string to be initialized */
203 PCWSTR source
) /* [I] '\0' terminated unicode string used to initialize target */
205 if (source
!= NULL
) {
206 unsigned int len
= strlenW(source
) * sizeof(WCHAR
);
209 return STATUS_NAME_TOO_LONG
;
211 target
->Length
= len
;
212 target
->MaximumLength
= len
+ sizeof(WCHAR
);
213 target
->Buffer
= (PWSTR
) source
;
217 target
->MaximumLength
= 0;
218 target
->Buffer
= NULL
;
220 return STATUS_SUCCESS
;
224 /**************************************************************************
225 * RtlCreateUnicodeString (NTDLL.@)
227 * Creates a UNICODE_STRING from a null-terminated Unicode string.
233 BOOLEAN WINAPI
RtlCreateUnicodeString( PUNICODE_STRING target
, LPCWSTR src
)
235 int len
= (strlenW(src
) + 1) * sizeof(WCHAR
);
236 if (!(target
->Buffer
= RtlAllocateHeap( GetProcessHeap(), 0, len
))) return FALSE
;
237 memcpy( target
->Buffer
, src
, len
);
238 target
->MaximumLength
= len
;
239 target
->Length
= len
- sizeof(WCHAR
);
244 /**************************************************************************
245 * RtlCreateUnicodeStringFromAsciiz (NTDLL.@)
247 * Creates a UNICODE_STRING from a null-terminated Ascii string.
253 BOOLEAN WINAPI
RtlCreateUnicodeStringFromAsciiz( PUNICODE_STRING target
, LPCSTR src
)
256 RtlInitAnsiString( &ansi
, src
);
257 return !RtlAnsiStringToUnicodeString( target
, &ansi
, TRUE
);
261 /**************************************************************************
262 * RtlFreeUnicodeString (NTDLL.@)
264 * Frees a UNICODE_STRING created with RtlCreateUnicodeString() or
265 * RtlCreateUnicodeStringFromAsciiz().
270 void WINAPI
RtlFreeUnicodeString( PUNICODE_STRING str
)
272 if (str
->Buffer
) RtlFreeHeap( GetProcessHeap(), 0, str
->Buffer
);
276 /**************************************************************************
277 * RtlCopyUnicodeString (NTDLL.@)
279 * Copies from one UNICODE_STRING to another.
284 void WINAPI
RtlCopyUnicodeString( UNICODE_STRING
*dst
, const UNICODE_STRING
*src
)
288 unsigned int len
= min( src
->Length
, dst
->MaximumLength
);
289 memcpy( dst
->Buffer
, src
->Buffer
, len
);
291 /* append terminating '\0' if enough space */
292 if (len
< dst
->MaximumLength
) dst
->Buffer
[len
/ sizeof(WCHAR
)] = 0;
294 else dst
->Length
= 0;
298 /**************************************************************************
299 * RtlDuplicateUnicodeString (NTDLL.@)
301 * Duplicates an unicode string.
304 * Success: STATUS_SUCCESS. destination contains the duplicated unicode string.
305 * Failure: STATUS_INVALID_PARAMETER, if one of the parameters is illegal.
306 * STATUS_NO_MEMORY, if the allocation fails.
309 * For add_nul there are several possible values:
310 * 0 = destination will not be '\0' terminated,
311 * 1 = destination will be '\0' terminated,
312 * 3 = like 1 but for an empty source string produce '\0' terminated empty
313 * Buffer instead of assigning NULL to the Buffer.
314 * Other add_nul values are invalid.
316 NTSTATUS WINAPI
RtlDuplicateUnicodeString(
317 int add_nul
, /* [I] flag */
318 const UNICODE_STRING
*source
, /* [I] Unicode string to be duplicated */
319 UNICODE_STRING
*destination
) /* [O] destination for the duplicated unicode string */
321 if (source
== NULL
|| destination
== NULL
||
322 source
->Length
> source
->MaximumLength
||
323 (source
->Length
== 0 && source
->MaximumLength
> 0 && source
->Buffer
== NULL
) ||
324 add_nul
== 2 || add_nul
>= 4 || add_nul
< 0) {
325 return STATUS_INVALID_PARAMETER
;
327 if (source
->Length
== 0 && add_nul
!= 3) {
328 destination
->Length
= 0;
329 destination
->MaximumLength
= 0;
330 destination
->Buffer
= NULL
;
332 unsigned int destination_max_len
= source
->Length
;
335 destination_max_len
+= sizeof(WCHAR
);
337 destination
->Buffer
= RtlAllocateHeap(GetProcessHeap(), 0, destination_max_len
);
338 if (destination
->Buffer
== NULL
) {
339 return STATUS_NO_MEMORY
;
341 memcpy(destination
->Buffer
, source
->Buffer
, source
->Length
);
342 destination
->Length
= source
->Length
;
343 destination
->MaximumLength
= source
->Length
;
344 /* append terminating '\0' if enough space */
346 destination
->MaximumLength
= destination_max_len
;
347 destination
->Buffer
[destination
->Length
/ sizeof(WCHAR
)] = 0;
352 return STATUS_SUCCESS
;
356 /**************************************************************************
357 * RtlEraseUnicodeString (NTDLL.@)
359 * Overwrites a UNICODE_STRING with zeros.
364 void WINAPI
RtlEraseUnicodeString( UNICODE_STRING
*str
)
368 memset( str
->Buffer
, 0, str
->MaximumLength
);
379 /******************************************************************************
380 * RtlCompareString (NTDLL.@)
382 LONG WINAPI
RtlCompareString( const STRING
*s1
, const STRING
*s2
, BOOLEAN CaseInsensitive
)
388 len
= min(s1
->Length
, s2
->Length
);
394 while (!ret
&& len
--) ret
= RtlUpperChar(*p1
++) - RtlUpperChar(*p2
++);
398 while (!ret
&& len
--) ret
= *p1
++ - *p2
++;
400 if (!ret
) ret
= s1
->Length
- s2
->Length
;
405 /******************************************************************************
406 * RtlCompareUnicodeString (NTDLL.@)
408 LONG WINAPI
RtlCompareUnicodeString( const UNICODE_STRING
*s1
, const UNICODE_STRING
*s2
,
409 BOOLEAN CaseInsensitive
)
415 len
= min(s1
->Length
, s2
->Length
) / sizeof(WCHAR
);
421 while (!ret
&& len
--) ret
= toupperW(*p1
++) - toupperW(*p2
++);
425 while (!ret
&& len
--) ret
= *p1
++ - *p2
++;
427 if (!ret
) ret
= s1
->Length
- s2
->Length
;
432 /**************************************************************************
433 * RtlEqualString (NTDLL.@)
435 * Determine if two strings are equal.
438 * s1 [I] Source string
439 * s2 [I] String to compare to s1
440 * CaseInsensitive [I] TRUE = Case insensitive, FALSE = Case sensitive
443 * Non-zero if s1 is equal to s2, 0 otherwise.
445 BOOLEAN WINAPI
RtlEqualString( const STRING
*s1
, const STRING
*s2
, BOOLEAN CaseInsensitive
)
447 if (s1
->Length
!= s2
->Length
) return FALSE
;
448 return !RtlCompareString( s1
, s2
, CaseInsensitive
);
452 /**************************************************************************
453 * RtlEqualUnicodeString (NTDLL.@)
455 * Unicode version of RtlEqualString.
457 BOOLEAN WINAPI
RtlEqualUnicodeString( const UNICODE_STRING
*s1
, const UNICODE_STRING
*s2
,
458 BOOLEAN CaseInsensitive
)
460 if (s1
->Length
!= s2
->Length
) return FALSE
;
461 return !RtlCompareUnicodeString( s1
, s2
, CaseInsensitive
);
465 /**************************************************************************
466 * RtlPrefixString (NTDLL.@)
468 * Determine if one string is a prefix of another.
471 * s1 [I] Prefix to look for in s2
472 * s2 [I] String that may contain s1 as a prefix
473 * ignore_case [I] TRUE = Case insensitive, FALSE = Case sensitive
476 * TRUE if s2 contains s1 as a prefix, FALSE otherwise.
478 BOOLEAN WINAPI
RtlPrefixString( const STRING
*s1
, const STRING
*s2
, BOOLEAN ignore_case
)
482 if (s1
->Length
> s2
->Length
) return FALSE
;
485 for (i
= 0; i
< s1
->Length
; i
++)
486 if (RtlUpperChar(s1
->Buffer
[i
]) != RtlUpperChar(s2
->Buffer
[i
])) return FALSE
;
490 for (i
= 0; i
< s1
->Length
; i
++)
491 if (s1
->Buffer
[i
] != s2
->Buffer
[i
]) return FALSE
;
497 /**************************************************************************
498 * RtlPrefixUnicodeString (NTDLL.@)
500 * Unicode version of RtlPrefixString.
502 BOOLEAN WINAPI
RtlPrefixUnicodeString( const UNICODE_STRING
*s1
,
503 const UNICODE_STRING
*s2
,
504 BOOLEAN ignore_case
)
508 if (s1
->Length
> s2
->Length
) return FALSE
;
511 for (i
= 0; i
< s1
->Length
/ sizeof(WCHAR
); i
++)
512 if (toupperW(s1
->Buffer
[i
]) != toupperW(s2
->Buffer
[i
])) return FALSE
;
516 for (i
= 0; i
< s1
->Length
/ sizeof(WCHAR
); i
++)
517 if (s1
->Buffer
[i
] != s2
->Buffer
[i
]) return FALSE
;
523 /**************************************************************************
524 * RtlEqualComputerName (NTDLL.@)
526 * Determine if two computer names are the same.
529 * left [I] First computer name
530 * right [I] Second computer name
533 * 0 if the names are equal, non-zero otherwise.
536 * The comparison is case insensitive.
538 NTSTATUS WINAPI
RtlEqualComputerName(const UNICODE_STRING
*left
,
539 const UNICODE_STRING
*right
)
542 STRING upLeft
, upRight
;
544 if (!(ret
= RtlUpcaseUnicodeStringToOemString( &upLeft
, left
, TRUE
)))
546 if (!(ret
= RtlUpcaseUnicodeStringToOemString( &upRight
, right
, TRUE
)))
548 ret
= RtlEqualString( &upLeft
, &upRight
, FALSE
);
549 RtlFreeOemString( &upRight
);
551 RtlFreeOemString( &upLeft
);
557 /**************************************************************************
558 * RtlEqualDomainName (NTDLL.@)
560 * Determine if two domain names are the same.
563 * left [I] First domain name
564 * right [I] Second domain name
567 * 0 if the names are equal, non-zero otherwise.
570 * The comparison is case insensitive.
572 NTSTATUS WINAPI
RtlEqualDomainName(const UNICODE_STRING
*left
,
573 const UNICODE_STRING
*right
)
575 return RtlEqualComputerName(left
, right
);
580 COPY BETWEEN ANSI_STRING or UNICODE_STRING
581 there is no parameter checking, it just crashes
585 /**************************************************************************
586 * RtlAnsiStringToUnicodeString (NTDLL.@)
588 * Converts an ansi string to an unicode string.
591 * Success: STATUS_SUCCESS. uni contains the converted string
592 * Failure: STATUS_BUFFER_OVERFLOW, if doalloc is FALSE and ansi is too small.
593 * STATUS_NO_MEMORY, if doalloc is TRUE and the allocation fails.
594 * STATUS_INVALID_PARAMETER_2, if the unicode string would be larger than 65535.
597 * This function always writes a terminating '\0'.
599 NTSTATUS WINAPI
RtlAnsiStringToUnicodeString(
600 PUNICODE_STRING uni
, /* [I/O] Destination for the unicode string */
601 PCANSI_STRING ansi
, /* [I] Ansi string to be converted */
602 BOOLEAN doalloc
) /* [I] TRUE=Allocate new buffer for uni, FALSE=Use existing buffer */
604 DWORD total
= RtlAnsiStringToUnicodeSize( ansi
);
606 if (total
> 0xffff) return STATUS_INVALID_PARAMETER_2
;
607 uni
->Length
= total
- sizeof(WCHAR
);
610 uni
->MaximumLength
= total
;
611 if (!(uni
->Buffer
= RtlAllocateHeap( GetProcessHeap(), 0, total
)))
612 return STATUS_NO_MEMORY
;
614 else if (total
> uni
->MaximumLength
) return STATUS_BUFFER_OVERFLOW
;
616 RtlMultiByteToUnicodeN( uni
->Buffer
, uni
->Length
, NULL
, ansi
->Buffer
, ansi
->Length
);
617 uni
->Buffer
[uni
->Length
/ sizeof(WCHAR
)] = 0;
618 return STATUS_SUCCESS
;
622 /**************************************************************************
623 * RtlOemStringToUnicodeString (NTDLL.@)
625 * Converts an oem string to an unicode string.
628 * Success: STATUS_SUCCESS. uni contains the converted string
629 * Failure: STATUS_BUFFER_OVERFLOW, if doalloc is FALSE and oem is too small.
630 * STATUS_NO_MEMORY, if doalloc is TRUE and the allocation fails.
631 * STATUS_INVALID_PARAMETER_2, if the unicode string would be larger than 65535.
634 * This function always writes a terminating '\0'.
636 NTSTATUS WINAPI
RtlOemStringToUnicodeString(
637 UNICODE_STRING
*uni
, /* [I/O] Destination for the unicode string */
638 const STRING
*oem
, /* [I] Oem string to be converted */
639 BOOLEAN doalloc
) /* [I] TRUE=Allocate new buffer for uni, FALSE=Use existing buffer */
641 DWORD total
= RtlOemStringToUnicodeSize( oem
);
643 if (total
> 0xffff) return STATUS_INVALID_PARAMETER_2
;
644 uni
->Length
= total
- sizeof(WCHAR
);
647 uni
->MaximumLength
= total
;
648 if (!(uni
->Buffer
= RtlAllocateHeap( GetProcessHeap(), 0, total
)))
649 return STATUS_NO_MEMORY
;
651 else if (total
> uni
->MaximumLength
) return STATUS_BUFFER_OVERFLOW
;
653 RtlOemToUnicodeN( uni
->Buffer
, uni
->Length
, NULL
, oem
->Buffer
, oem
->Length
);
654 uni
->Buffer
[uni
->Length
/ sizeof(WCHAR
)] = 0;
655 return STATUS_SUCCESS
;
659 /**************************************************************************
660 * RtlUnicodeStringToAnsiString (NTDLL.@)
662 * Converts an unicode string to an ansi string.
665 * Success: STATUS_SUCCESS. ansi contains the converted string
666 * Failure: STATUS_BUFFER_OVERFLOW, if doalloc is FALSE and ansi is too small.
667 * STATUS_NO_MEMORY, if doalloc is TRUE and the allocation fails.
670 * This function always writes a terminating '\0'.
671 * It performs a partial copy if ansi is too small.
673 NTSTATUS WINAPI
RtlUnicodeStringToAnsiString(
674 STRING
*ansi
, /* [I/O] Destination for the ansi string */
675 const UNICODE_STRING
*uni
, /* [I] Unicode string to be converted */
676 BOOLEAN doalloc
) /* [I] TRUE=Allocate new buffer for ansi, FALSE=Use existing buffer */
678 NTSTATUS ret
= STATUS_SUCCESS
;
679 DWORD len
= RtlUnicodeStringToAnsiSize( uni
);
681 ansi
->Length
= len
- 1;
684 ansi
->MaximumLength
= len
;
685 if (!(ansi
->Buffer
= RtlAllocateHeap( GetProcessHeap(), 0, len
)))
686 return STATUS_NO_MEMORY
;
688 else if (ansi
->MaximumLength
< len
)
690 if (!ansi
->MaximumLength
) return STATUS_BUFFER_OVERFLOW
;
691 ansi
->Length
= ansi
->MaximumLength
- 1;
692 ret
= STATUS_BUFFER_OVERFLOW
;
695 RtlUnicodeToMultiByteN( ansi
->Buffer
, ansi
->Length
, NULL
, uni
->Buffer
, uni
->Length
);
696 ansi
->Buffer
[ansi
->Length
] = 0;
701 /**************************************************************************
702 * RtlUnicodeStringToOemString (NTDLL.@)
704 * Converts a Rtl Unicode string to an OEM string.
707 * oem [O] Destination for OEM string
708 * uni [I] Source Unicode string
709 * doalloc [I] TRUE=Allocate new buffer for oem,FALSE=Use existing buffer
712 * Success: STATUS_SUCCESS. oem contains the converted string
713 * Failure: STATUS_BUFFER_OVERFLOW, if doalloc is FALSE and oem is too small.
714 * STATUS_NO_MEMORY, if doalloc is TRUE and allocation fails.
717 * If doalloc is TRUE, the length allocated is uni->Length + 1.
718 * This function always '\0' terminates the string returned.
720 NTSTATUS WINAPI
RtlUnicodeStringToOemString( STRING
*oem
,
721 const UNICODE_STRING
*uni
,
724 NTSTATUS ret
= STATUS_SUCCESS
;
725 DWORD len
= RtlUnicodeStringToOemSize( uni
);
727 oem
->Length
= len
- 1;
730 oem
->MaximumLength
= len
;
731 if (!(oem
->Buffer
= RtlAllocateHeap( GetProcessHeap(), 0, len
)))
732 return STATUS_NO_MEMORY
;
734 else if (oem
->MaximumLength
< len
)
736 if (!oem
->MaximumLength
) return STATUS_BUFFER_OVERFLOW
;
737 oem
->Length
= oem
->MaximumLength
- 1;
738 ret
= STATUS_BUFFER_OVERFLOW
;
741 RtlUnicodeToOemN( oem
->Buffer
, oem
->Length
, NULL
, uni
->Buffer
, uni
->Length
);
742 oem
->Buffer
[oem
->Length
] = 0;
747 /**************************************************************************
748 * RtlMultiByteToUnicodeN (NTDLL.@)
750 * Converts a multi-byte string to a Unicode string.
756 * Performs a partial copy if dst is too small.
758 NTSTATUS WINAPI
RtlMultiByteToUnicodeN( LPWSTR dst
, DWORD dstlen
, LPDWORD reslen
,
759 LPCSTR src
, DWORD srclen
)
762 int ret
= wine_cp_mbstowcs( ansi_table
, 0, src
, srclen
, dst
, dstlen
/sizeof(WCHAR
) );
764 *reslen
= (ret
>= 0) ? ret
*sizeof(WCHAR
) : dstlen
; /* overflow -> we filled up to dstlen */
765 return STATUS_SUCCESS
;
769 /**************************************************************************
770 * RtlOemToUnicodeN (NTDLL.@)
772 * Converts a multi-byte string in the OEM code page to a Unicode string.
777 NTSTATUS WINAPI
RtlOemToUnicodeN( LPWSTR dst
, DWORD dstlen
, LPDWORD reslen
,
778 LPCSTR src
, DWORD srclen
)
780 int ret
= wine_cp_mbstowcs( oem_table
, 0, src
, srclen
, dst
, dstlen
/sizeof(WCHAR
) );
782 *reslen
= (ret
>= 0) ? ret
*sizeof(WCHAR
) : dstlen
; /* overflow -> we filled up to dstlen */
783 return STATUS_SUCCESS
;
787 /**************************************************************************
788 * RtlUnicodeToMultiByteN (NTDLL.@)
790 * Converts a Unicode string to a multi-byte string in the ANSI code page.
795 NTSTATUS WINAPI
RtlUnicodeToMultiByteN( LPSTR dst
, DWORD dstlen
, LPDWORD reslen
,
796 LPCWSTR src
, DWORD srclen
)
798 int ret
= wine_cp_wcstombs( ansi_table
, 0, src
, srclen
/ sizeof(WCHAR
),
799 dst
, dstlen
, NULL
, NULL
);
801 *reslen
= (ret
>= 0) ? ret
: dstlen
; /* overflow -> we filled up to dstlen */
802 return STATUS_SUCCESS
;
806 /**************************************************************************
807 * RtlUnicodeToOemN (NTDLL.@)
809 * Converts a Unicode string to a multi-byte string in the OEM code page.
814 NTSTATUS WINAPI
RtlUnicodeToOemN( LPSTR dst
, DWORD dstlen
, LPDWORD reslen
,
815 LPCWSTR src
, DWORD srclen
)
817 int ret
= wine_cp_wcstombs( oem_table
, 0, src
, srclen
/ sizeof(WCHAR
),
818 dst
, dstlen
, NULL
, NULL
);
820 *reslen
= (ret
>= 0) ? ret
: dstlen
; /* overflow -> we filled up to dstlen */
821 return STATUS_SUCCESS
;
830 /**************************************************************************
831 * RtlUpperChar (NTDLL.@)
833 * Converts an Ascii character to uppercase.
836 * ch [I] Character to convert
839 * The uppercase character value.
842 * For the input characters from 'a' .. 'z' it returns 'A' .. 'Z'.
843 * All other input characters are returned unchanged. The locale and
844 * multibyte characters are not taken into account (as native DLL).
846 CHAR WINAPI
RtlUpperChar( CHAR ch
)
848 if (ch
>= 'a' && ch
<= 'z') {
849 return ch
- 'a' + 'A';
856 /**************************************************************************
857 * RtlUpperString (NTDLL.@)
859 * Converts an Ascii string to uppercase.
862 * dst [O] Destination for converted string
863 * src [I] Source string to convert
869 * For the src characters from 'a' .. 'z' it assigns 'A' .. 'Z' to dst.
870 * All other src characters are copied unchanged to dst. The locale and
871 * multibyte characters are not taken into account (as native DLL).
872 * The number of character copied is the minimum of src->Length and
873 * the dst->MaximumLength.
875 void WINAPI
RtlUpperString( STRING
*dst
, const STRING
*src
)
877 unsigned int i
, len
= min(src
->Length
, dst
->MaximumLength
);
879 for (i
= 0; i
< len
; i
++) dst
->Buffer
[i
] = RtlUpperChar(src
->Buffer
[i
]);
884 /**************************************************************************
885 * RtlUpcaseUnicodeChar (NTDLL.@)
887 * Converts an Unicode character to uppercase.
890 * wch [I] Character to convert
893 * The uppercase character value.
895 WCHAR WINAPI
RtlUpcaseUnicodeChar( WCHAR wch
)
897 return toupperW(wch
);
901 /**************************************************************************
902 * RtlDowncaseUnicodeChar (NTDLL.@)
904 * Converts an Unicode character to lowercase.
907 * wch [I] Character to convert
910 * The lowercase character value.
912 WCHAR WINAPI
RtlDowncaseUnicodeChar(WCHAR wch
)
914 return tolowerW(wch
);
918 /**************************************************************************
919 * RtlUpcaseUnicodeString (NTDLL.@)
921 * Converts an Unicode string to uppercase.
924 * dest [O] Destination for converted string
925 * src [I] Source string to convert
926 * doalloc [I] TRUE=Allocate a buffer for dest if it doesn't have one
929 * Success: STATUS_SUCCESS. dest contains the converted string.
930 * Failure: STATUS_NO_MEMORY, if doalloc is TRUE and memory allocation fails, or
931 * STATUS_BUFFER_OVERFLOW, if doalloc is FALSE and dest is too small.
934 * dest is never '\0' terminated because it may be equal to src, and src
935 * might not be '\0' terminated. dest->Length is only set upon success.
937 NTSTATUS WINAPI
RtlUpcaseUnicodeString( UNICODE_STRING
*dest
,
938 const UNICODE_STRING
*src
,
941 DWORD i
, len
= src
->Length
;
945 dest
->MaximumLength
= len
;
946 if (!(dest
->Buffer
= RtlAllocateHeap( GetProcessHeap(), 0, len
)))
947 return STATUS_NO_MEMORY
;
949 else if (len
> dest
->MaximumLength
) return STATUS_BUFFER_OVERFLOW
;
951 for (i
= 0; i
< len
/sizeof(WCHAR
); i
++) dest
->Buffer
[i
] = toupperW(src
->Buffer
[i
]);
953 return STATUS_SUCCESS
;
957 /**************************************************************************
958 * RtlDowncaseUnicodeString (NTDLL.@)
960 * Converts an Unicode string to lowercase.
963 * dest [O] Destination for converted string
964 * src [I] Source string to convert
965 * doalloc [I] TRUE=Allocate a buffer for dest if it doesn't have one
968 * Success: STATUS_SUCCESS. dest contains the converted string.
969 * Failure: STATUS_NO_MEMORY, if doalloc is TRUE and memory allocation fails, or
970 * STATUS_BUFFER_OVERFLOW, if doalloc is FALSE and dest is too small.
973 * dest is never '\0' terminated because it may be equal to src, and src
974 * might not be '\0' terminated. dest->Length is only set upon success.
976 NTSTATUS WINAPI
RtlDowncaseUnicodeString(
977 UNICODE_STRING
*dest
,
978 const UNICODE_STRING
*src
,
982 DWORD len
= src
->Length
;
985 dest
->MaximumLength
= len
;
986 if (!(dest
->Buffer
= RtlAllocateHeap( GetProcessHeap(), 0, len
))) {
987 return STATUS_NO_MEMORY
;
989 } else if (len
> dest
->MaximumLength
) {
990 return STATUS_BUFFER_OVERFLOW
;
993 for (i
= 0; i
< len
/sizeof(WCHAR
); i
++) {
994 dest
->Buffer
[i
] = tolowerW(src
->Buffer
[i
]);
997 return STATUS_SUCCESS
;
1001 /**************************************************************************
1002 * RtlUpcaseUnicodeStringToAnsiString (NTDLL.@)
1004 * Converts a Unicode string to the equivalent ANSI upper-case representation.
1010 * writes terminating 0
1012 NTSTATUS WINAPI
RtlUpcaseUnicodeStringToAnsiString( STRING
*dst
,
1013 const UNICODE_STRING
*src
,
1017 UNICODE_STRING upcase
;
1019 if (!(ret
= RtlUpcaseUnicodeString( &upcase
, src
, TRUE
)))
1021 ret
= RtlUnicodeStringToAnsiString( dst
, &upcase
, doalloc
);
1022 RtlFreeUnicodeString( &upcase
);
1028 /**************************************************************************
1029 * RtlUpcaseUnicodeStringToOemString (NTDLL.@)
1031 * Converts a UNICODE_STRING to the equivalent OEM upper-case representation
1032 * stored in STRING format.
1038 * writes terminating 0
1040 NTSTATUS WINAPI
RtlUpcaseUnicodeStringToOemString( STRING
*dst
,
1041 const UNICODE_STRING
*src
,
1045 UNICODE_STRING upcase
;
1047 if (!(ret
= RtlUpcaseUnicodeString( &upcase
, src
, TRUE
)))
1049 ret
= RtlUnicodeStringToOemString( dst
, &upcase
, doalloc
);
1050 RtlFreeUnicodeString( &upcase
);
1056 /**************************************************************************
1057 * RtlUpcaseUnicodeStringToCountedOemString (NTDLL.@)
1059 * Converts a UNICODE_STRING to the equivalent OEM upper-case representation
1060 * stored in STRING format.
1066 * Same as RtlUpcaseUnicodeStringToOemString but doesn't write terminating null
1068 NTSTATUS WINAPI
RtlUpcaseUnicodeStringToCountedOemString( STRING
*oem
,
1069 const UNICODE_STRING
*uni
,
1073 UNICODE_STRING upcase
;
1076 upcase
.Buffer
= tmp
;
1077 upcase
.MaximumLength
= sizeof(tmp
);
1078 ret
= RtlUpcaseUnicodeString( &upcase
, uni
, FALSE
);
1079 if (ret
== STATUS_BUFFER_OVERFLOW
) ret
= RtlUpcaseUnicodeString( &upcase
, uni
, TRUE
);
1083 DWORD len
= RtlUnicodeStringToOemSize( &upcase
) - 1;
1087 oem
->MaximumLength
= len
;
1088 if (!(oem
->Buffer
= RtlAllocateHeap( GetProcessHeap(), 0, len
)))
1090 ret
= STATUS_NO_MEMORY
;
1094 else if (oem
->MaximumLength
< len
)
1096 ret
= STATUS_BUFFER_OVERFLOW
;
1097 oem
->Length
= oem
->MaximumLength
;
1098 if (!oem
->MaximumLength
) goto done
;
1100 RtlUnicodeToOemN( oem
->Buffer
, oem
->Length
, NULL
, upcase
.Buffer
, upcase
.Length
);
1102 if (upcase
.Buffer
!= tmp
) RtlFreeUnicodeString( &upcase
);
1108 /**************************************************************************
1109 * RtlUpcaseUnicodeToMultiByteN (NTDLL.@)
1111 * Converts a Unicode string to the equivalent ANSI upper-case representation.
1116 NTSTATUS WINAPI
RtlUpcaseUnicodeToMultiByteN( LPSTR dst
, DWORD dstlen
, LPDWORD reslen
,
1117 LPCWSTR src
, DWORD srclen
)
1123 if (!(upcase
= RtlAllocateHeap( GetProcessHeap(), 0, srclen
))) return STATUS_NO_MEMORY
;
1124 for (i
= 0; i
< srclen
/sizeof(WCHAR
); i
++) upcase
[i
] = toupperW(src
[i
]);
1125 ret
= RtlUnicodeToMultiByteN( dst
, dstlen
, reslen
, upcase
, srclen
);
1126 RtlFreeHeap( GetProcessHeap(), 0, upcase
);
1131 /**************************************************************************
1132 * RtlUpcaseUnicodeToOemN (NTDLL.@)
1134 * Converts a Unicode string to the equivalent OEM upper-case representation.
1139 NTSTATUS WINAPI
RtlUpcaseUnicodeToOemN( LPSTR dst
, DWORD dstlen
, LPDWORD reslen
,
1140 LPCWSTR src
, DWORD srclen
)
1146 if (!(upcase
= RtlAllocateHeap( GetProcessHeap(), 0, srclen
))) return STATUS_NO_MEMORY
;
1147 for (i
= 0; i
< srclen
/sizeof(WCHAR
); i
++) upcase
[i
] = toupperW(src
[i
]);
1148 ret
= RtlUnicodeToOemN( dst
, dstlen
, reslen
, upcase
, srclen
);
1149 RtlFreeHeap( GetProcessHeap(), 0, upcase
);
1159 /**************************************************************************
1160 * RtlOemStringToUnicodeSize (NTDLL.@)
1161 * RtlxOemStringToUnicodeSize (NTDLL.@)
1163 * Calculate the size in bytes necessary for the Unicode conversion of str,
1164 * including the terminating '\0'.
1167 * str [I] String to calculate the size of
1170 * The calculated size.
1172 UINT WINAPI
RtlOemStringToUnicodeSize( const STRING
*str
)
1174 int ret
= wine_cp_mbstowcs( oem_table
, 0, str
->Buffer
, str
->Length
, NULL
, 0 );
1175 return (ret
+ 1) * sizeof(WCHAR
);
1179 /**************************************************************************
1180 * RtlAnsiStringToUnicodeSize (NTDLL.@)
1181 * RtlxAnsiStringToUnicodeSize (NTDLL.@)
1183 * Calculate the size in bytes necessary for the Unicode conversion of str,
1184 * including the terminating '\0'.
1187 * str [I] String to calculate the size of
1190 * The calculated size.
1192 DWORD WINAPI
RtlAnsiStringToUnicodeSize( const STRING
*str
)
1195 RtlMultiByteToUnicodeSize( &ret
, str
->Buffer
, str
->Length
);
1196 return ret
+ sizeof(WCHAR
);
1200 /**************************************************************************
1201 * RtlMultiByteToUnicodeSize (NTDLL.@)
1203 * Compute the size in bytes necessary for the Unicode conversion of str,
1204 * without the terminating '\0'.
1207 * size [O] Destination for size
1208 * str [I] String to calculate the size of
1209 * len [I] Length of str
1214 NTSTATUS WINAPI
RtlMultiByteToUnicodeSize( DWORD
*size
, LPCSTR str
, UINT len
)
1216 *size
= wine_cp_mbstowcs( ansi_table
, 0, str
, len
, NULL
, 0 ) * sizeof(WCHAR
);
1217 return STATUS_SUCCESS
;
1221 /**************************************************************************
1222 * RtlUnicodeToMultiByteSize (NTDLL.@)
1224 * Calculate the size in bytes necessary for the multibyte conversion of str,
1225 * without the terminating '\0'.
1228 * size [O] Destination for size
1229 * str [I] String to calculate the size of
1230 * len [I] Length of str
1235 NTSTATUS WINAPI
RtlUnicodeToMultiByteSize( PULONG size
, LPCWSTR str
, ULONG len
)
1237 *size
= wine_cp_wcstombs( ansi_table
, 0, str
, len
/ sizeof(WCHAR
), NULL
, 0, NULL
, NULL
);
1238 return STATUS_SUCCESS
;
1242 /**************************************************************************
1243 * RtlUnicodeStringToAnsiSize (NTDLL.@)
1244 * RtlxUnicodeStringToAnsiSize (NTDLL.@)
1246 * Calculate the size in bytes necessary for the Ansi conversion of str,
1247 * including the terminating '\0'.
1250 * str [I] String to calculate the size of
1253 * The calculated size.
1255 DWORD WINAPI
RtlUnicodeStringToAnsiSize( const UNICODE_STRING
*str
)
1258 RtlUnicodeToMultiByteSize( &ret
, str
->Buffer
, str
->Length
);
1263 /**************************************************************************
1264 * RtlUnicodeStringToOemSize (NTDLL.@)
1265 * RtlxUnicodeStringToOemSize (NTDLL.@)
1267 * Calculate the size in bytes necessary for the OEM conversion of str,
1268 * including the terminating '\0'.
1271 * str [I] String to calculate the size of
1274 * The calculated size.
1276 DWORD WINAPI
RtlUnicodeStringToOemSize( const UNICODE_STRING
*str
)
1278 return wine_cp_wcstombs( oem_table
, 0, str
->Buffer
, str
->Length
/ sizeof(WCHAR
),
1279 NULL
, 0, NULL
, NULL
) + 1;
1283 /**************************************************************************
1284 * RtlAppendAsciizToString (NTDLL.@)
1286 * Concatenates a buffered character string and a '\0' terminated character
1290 * Success: STATUS_SUCCESS. src is appended to dest.
1291 * Failure: STATUS_BUFFER_TOO_SMALL, if the buffer of dest is too small
1292 * to hold the concatenated string.
1295 * if src is NULL dest is unchanged.
1296 * dest is never '\0' terminated.
1298 NTSTATUS WINAPI
RtlAppendAsciizToString(
1299 STRING
*dest
, /* [I/O] Buffered character string to which src is concatenated */
1300 LPCSTR src
) /* [I] '\0' terminated character string to be concatenated */
1303 unsigned int src_len
= strlen(src
);
1304 unsigned int dest_len
= src_len
+ dest
->Length
;
1306 if (dest_len
> dest
->MaximumLength
) return STATUS_BUFFER_TOO_SMALL
;
1307 memcpy(dest
->Buffer
+ dest
->Length
, src
, src_len
);
1308 dest
->Length
= dest_len
;
1310 return STATUS_SUCCESS
;
1314 /**************************************************************************
1315 * RtlAppendStringToString (NTDLL.@)
1317 * Concatenates two buffered character strings
1320 * Success: STATUS_SUCCESS. src is appended to dest.
1321 * Failure: STATUS_BUFFER_TOO_SMALL, if the buffer of dest is too small
1322 * to hold the concatenated string.
1325 * if src->length is zero dest is unchanged.
1326 * dest is never '\0' terminated.
1328 NTSTATUS WINAPI
RtlAppendStringToString(
1329 STRING
*dest
, /* [I/O] Buffered character string to which src is concatenated */
1330 const STRING
*src
) /* [I] Buffered character string to be concatenated */
1332 if (src
->Length
!= 0) {
1333 unsigned int dest_len
= src
->Length
+ dest
->Length
;
1335 if (dest_len
> dest
->MaximumLength
) return STATUS_BUFFER_TOO_SMALL
;
1336 memcpy(dest
->Buffer
+ dest
->Length
, src
->Buffer
, src
->Length
);
1337 dest
->Length
= dest_len
;
1339 return STATUS_SUCCESS
;
1343 /**************************************************************************
1344 * RtlAppendUnicodeToString (NTDLL.@)
1346 * Concatenates a buffered unicode string and a '\0' terminated unicode
1350 * Success: STATUS_SUCCESS. src is appended to dest.
1351 * Failure: STATUS_BUFFER_TOO_SMALL, if the buffer of dest is too small
1352 * to hold the concatenated string.
1355 * if src is NULL dest is unchanged.
1356 * dest is '\0' terminated when the MaximumLength allows it.
1357 * When dest fits exactly in MaximumLength characters the '\0' is omitted.
1360 * Does not write in the src->Buffer beyond MaximumLength when
1361 * MaximumLength is odd as the native function does.
1363 NTSTATUS WINAPI
RtlAppendUnicodeToString(
1364 UNICODE_STRING
*dest
, /* [I/O] Buffered unicode string to which src is concatenated */
1365 LPCWSTR src
) /* [I] '\0' terminated unicode string to be concatenated */
1368 unsigned int src_len
= strlenW(src
) * sizeof(WCHAR
);
1369 unsigned int dest_len
= src_len
+ dest
->Length
;
1371 if (dest_len
> dest
->MaximumLength
) return STATUS_BUFFER_TOO_SMALL
;
1372 memcpy(dest
->Buffer
+ dest
->Length
/sizeof(WCHAR
), src
, src_len
);
1373 dest
->Length
= dest_len
;
1374 /* append terminating '\0' if enough space */
1375 if (dest_len
+ sizeof(WCHAR
) <= dest
->MaximumLength
) {
1376 dest
->Buffer
[dest_len
/ sizeof(WCHAR
)] = 0;
1379 return STATUS_SUCCESS
;
1383 /**************************************************************************
1384 * RtlAppendUnicodeStringToString (NTDLL.@)
1386 * Concatenates two buffered unicode strings
1389 * Success: STATUS_SUCCESS. src is appended to dest.
1390 * Failure: STATUS_BUFFER_TOO_SMALL, if the buffer of dest is too small
1391 * to hold the concatenated string.
1394 * if src->length is zero dest is unchanged.
1395 * dest is '\0' terminated when the MaximumLength allows it.
1396 * When dest fits exactly in MaximumLength characters the '\0' is omitted.
1399 * Does not write in the src->Buffer beyond MaximumLength when
1400 * MaximumLength is odd as the native function does.
1402 NTSTATUS WINAPI
RtlAppendUnicodeStringToString(
1403 UNICODE_STRING
*dest
, /* [I/O] Buffered unicode string to which src is concatenated */
1404 const UNICODE_STRING
*src
) /* [I] Buffered unicode string to be concatenated */
1406 if (src
->Length
!= 0) {
1407 unsigned int dest_len
= src
->Length
+ dest
->Length
;
1409 if (dest_len
> dest
->MaximumLength
) return STATUS_BUFFER_TOO_SMALL
;
1410 memcpy(dest
->Buffer
+ dest
->Length
/sizeof(WCHAR
), src
->Buffer
, src
->Length
);
1411 dest
->Length
= dest_len
;
1412 /* append terminating '\0' if enough space */
1413 if (dest_len
+ sizeof(WCHAR
) <= dest
->MaximumLength
) {
1414 dest
->Buffer
[dest_len
/ sizeof(WCHAR
)] = 0;
1417 return STATUS_SUCCESS
;
1421 /**************************************************************************
1422 * RtlFindCharInUnicodeString (NTDLL.@)
1424 * Searches for one of several unicode characters in an unicode string.
1427 * Success: STATUS_SUCCESS. pos contains the position after the character found.
1428 * Failure: STATUS_NOT_FOUND, if none of the search_chars are in main_str.
1430 NTSTATUS WINAPI
RtlFindCharInUnicodeString(
1431 int flags
, /* [I] Flags */
1432 const UNICODE_STRING
*main_str
, /* [I] Unicode string in which one or more characters are searched */
1433 const UNICODE_STRING
*search_chars
, /* [I] Unicode string which contains the characters to search for */
1434 USHORT
*pos
) /* [O] Position of the first character found + 2 */
1437 unsigned int search_idx
;
1441 for (main_idx
= 0; main_idx
< main_str
->Length
/ sizeof(WCHAR
); main_idx
++) {
1442 for (search_idx
= 0; search_idx
< search_chars
->Length
/ sizeof(WCHAR
); search_idx
++) {
1443 if (main_str
->Buffer
[main_idx
] == search_chars
->Buffer
[search_idx
]) {
1444 *pos
= (main_idx
+ 1) * sizeof(WCHAR
);
1445 return STATUS_SUCCESS
;
1450 return STATUS_NOT_FOUND
;
1452 for (main_idx
= main_str
->Length
/ sizeof(WCHAR
) - 1; main_idx
>= 0; main_idx
--) {
1453 for (search_idx
= 0; search_idx
< search_chars
->Length
/ sizeof(WCHAR
); search_idx
++) {
1454 if (main_str
->Buffer
[main_idx
] == search_chars
->Buffer
[search_idx
]) {
1455 *pos
= main_idx
* sizeof(WCHAR
);
1456 return STATUS_SUCCESS
;
1461 return STATUS_NOT_FOUND
;
1463 for (main_idx
= 0; main_idx
< main_str
->Length
/ sizeof(WCHAR
); main_idx
++) {
1465 while (search_idx
< search_chars
->Length
/ sizeof(WCHAR
) &&
1466 main_str
->Buffer
[main_idx
] != search_chars
->Buffer
[search_idx
]) {
1469 if (search_idx
>= search_chars
->Length
/ sizeof(WCHAR
)) {
1470 *pos
= (main_idx
+ 1) * sizeof(WCHAR
);
1471 return STATUS_SUCCESS
;
1475 return STATUS_NOT_FOUND
;
1477 for (main_idx
= main_str
->Length
/ sizeof(WCHAR
) - 1; main_idx
>= 0; main_idx
--) {
1479 while (search_idx
< search_chars
->Length
/ sizeof(WCHAR
) &&
1480 main_str
->Buffer
[main_idx
] != search_chars
->Buffer
[search_idx
]) {
1483 if (search_idx
>= search_chars
->Length
/ sizeof(WCHAR
)) {
1484 *pos
= main_idx
* sizeof(WCHAR
);
1485 return STATUS_SUCCESS
;
1489 return STATUS_NOT_FOUND
;
1491 return STATUS_NOT_FOUND
;
1498 /* Tests that we currently implement */
1499 #define ITU_IMPLEMENTED_TESTS \
1500 (IS_TEXT_UNICODE_SIGNATURE | \
1501 IS_TEXT_UNICODE_REVERSE_SIGNATURE | \
1502 IS_TEXT_UNICODE_ODD_LENGTH | \
1503 IS_TEXT_UNICODE_STATISTICS | \
1504 IS_TEXT_UNICODE_NULL_BYTES)
1506 /**************************************************************************
1507 * RtlIsTextUnicode (NTDLL.@)
1509 * Attempt to guess whether a text buffer is Unicode.
1512 * buf [I] Text buffer to test
1513 * len [I] Length of buf
1514 * pf [O] Destination for test results
1517 * The length of the string if all tests were passed, 0 otherwise.
1520 * Should implement more tests.
1522 DWORD WINAPI
RtlIsTextUnicode(
1528 DWORD flags
= -1, out_flags
= 0;
1535 * Apply various tests to the text string. According to the
1536 * docs, each test "passed" sets the corresponding flag in
1537 * the output flags. But some of the tests are mutually
1538 * exclusive, so I don't see how you could pass all tests ...
1541 /* Check for an odd length ... pass if even. */
1542 if ((flags
& IS_TEXT_UNICODE_ODD_LENGTH
) && (len
& 1))
1543 out_flags
|= IS_TEXT_UNICODE_ODD_LENGTH
;
1545 /* Check for the special byte order unicode marks. */
1546 if ((flags
& IS_TEXT_UNICODE_SIGNATURE
) && *s
== 0xFEFF)
1547 out_flags
|= IS_TEXT_UNICODE_SIGNATURE
;
1549 if ((flags
& IS_TEXT_UNICODE_REVERSE_SIGNATURE
) && *s
== 0xFFFE)
1550 out_flags
|= IS_TEXT_UNICODE_REVERSE_SIGNATURE
;
1552 /* apply some statistical analysis */
1553 if (flags
& IS_TEXT_UNICODE_STATISTICS
)
1556 /* FIXME: checks only for ASCII characters in the unicode stream */
1557 for (i
= 0; i
< len
/ sizeof(WCHAR
); i
++)
1559 if (s
[i
] <= 255) stats
++;
1561 if (stats
> len
/ sizeof(WCHAR
) / 2)
1562 out_flags
|= IS_TEXT_UNICODE_STATISTICS
;
1565 /* Check for unicode NULL chars */
1566 if (flags
& IS_TEXT_UNICODE_NULL_BYTES
)
1569 for (i
= 0; i
< len
/ sizeof(WCHAR
); i
++)
1573 out_flags
|= IS_TEXT_UNICODE_NULL_BYTES
;
1580 * Check whether the string passed all of the tests.
1582 flags
&= ITU_IMPLEMENTED_TESTS
;
1583 if ((out_flags
& flags
) != flags
)
1592 /**************************************************************************
1593 * RtlCharToInteger (NTDLL.@)
1595 * Converts a character string into its integer equivalent.
1598 * Success: STATUS_SUCCESS. value contains the converted number
1599 * Failure: STATUS_INVALID_PARAMETER, if base is not 0, 2, 8, 10 or 16.
1600 * STATUS_ACCESS_VIOLATION, if value is NULL.
1603 * For base 0 it uses 10 as base and the string should be in the format
1604 * "{whitespace} [+|-] [0[x|o|b]] {digits}".
1605 * For other bases the string should be in the format
1606 * "{whitespace} [+|-] {digits}".
1607 * No check is made for value overflow, only the lower 32 bits are assigned.
1608 * If str is NULL it crashes, as the native function does.
1611 * This function does not read garbage behind '\0' as the native version does.
1613 NTSTATUS WINAPI
RtlCharToInteger(
1614 PCSZ str
, /* [I] '\0' terminated single-byte string containing a number */
1615 ULONG base
, /* [I] Number base for conversion (allowed 0, 2, 8, 10 or 16) */
1616 ULONG
*value
) /* [O] Destination for the converted value */
1620 ULONG RunningTotal
= 0;
1623 while (*str
!= '\0' && *str
<= ' ') {
1629 } else if (*str
== '-') {
1636 if (str
[0] == '0') {
1637 if (str
[1] == 'b') {
1640 } else if (str
[1] == 'o') {
1643 } else if (str
[1] == 'x') {
1648 } else if (base
!= 2 && base
!= 8 && base
!= 10 && base
!= 16) {
1649 return STATUS_INVALID_PARAMETER
;
1652 if (value
== NULL
) {
1653 return STATUS_ACCESS_VIOLATION
;
1656 while (*str
!= '\0') {
1658 if (chCurrent
>= '0' && chCurrent
<= '9') {
1659 digit
= chCurrent
- '0';
1660 } else if (chCurrent
>= 'A' && chCurrent
<= 'Z') {
1661 digit
= chCurrent
- 'A' + 10;
1662 } else if (chCurrent
>= 'a' && chCurrent
<= 'z') {
1663 digit
= chCurrent
- 'a' + 10;
1667 if (digit
< 0 || digit
>= base
) {
1668 *value
= bMinus
? -RunningTotal
: RunningTotal
;
1669 return STATUS_SUCCESS
;
1672 RunningTotal
= RunningTotal
* base
+ digit
;
1676 *value
= bMinus
? -RunningTotal
: RunningTotal
;
1677 return STATUS_SUCCESS
;
1681 /**************************************************************************
1682 * RtlIntegerToChar (NTDLL.@)
1684 * Converts an unsigned integer to a character string.
1687 * Success: STATUS_SUCCESS. str contains the converted number
1688 * Failure: STATUS_INVALID_PARAMETER, if base is not 0, 2, 8, 10 or 16.
1689 * STATUS_BUFFER_OVERFLOW, if str would be larger than length.
1690 * STATUS_ACCESS_VIOLATION, if str is NULL.
1693 * Instead of base 0 it uses 10 as base.
1694 * Writes at most length characters to the string str.
1695 * Str is '\0' terminated when length allows it.
1696 * When str fits exactly in length characters the '\0' is omitted.
1698 NTSTATUS WINAPI
RtlIntegerToChar(
1699 ULONG value
, /* [I] Value to be converted */
1700 ULONG base
, /* [I] Number base for conversion (allowed 0, 2, 8, 10 or 16) */
1701 ULONG length
, /* [I] Length of the str buffer in bytes */
1702 PCHAR str
) /* [O] Destination for the converted value */
1711 } else if (base
!= 2 && base
!= 8 && base
!= 10 && base
!= 16) {
1712 return STATUS_INVALID_PARAMETER
;
1720 digit
= value
% base
;
1721 value
= value
/ base
;
1725 *pos
= 'A' + digit
- 10;
1727 } while (value
!= 0L);
1729 len
= &buffer
[32] - pos
;
1731 return STATUS_BUFFER_OVERFLOW
;
1732 } else if (str
== NULL
) {
1733 return STATUS_ACCESS_VIOLATION
;
1734 } else if (len
== length
) {
1735 memcpy(str
, pos
, len
);
1737 memcpy(str
, pos
, len
+ 1);
1739 return STATUS_SUCCESS
;
1743 /**************************************************************************
1744 * RtlUnicodeStringToInteger (NTDLL.@)
1746 * Converts an unicode string into its integer equivalent.
1749 * Success: STATUS_SUCCESS. value contains the converted number
1750 * Failure: STATUS_INVALID_PARAMETER, if base is not 0, 2, 8, 10 or 16.
1751 * STATUS_ACCESS_VIOLATION, if value is NULL.
1754 * For base 0 it uses 10 as base and the string should be in the format
1755 * "{whitespace} [+|-] [0[x|o|b]] {digits}".
1756 * For other bases the string should be in the format
1757 * "{whitespace} [+|-] {digits}".
1758 * No check is made for value overflow, only the lower 32 bits are assigned.
1759 * If str is NULL it crashes, as the native function does.
1762 * This function does not read garbage on string length 0 as the native
1765 NTSTATUS WINAPI
RtlUnicodeStringToInteger(
1766 const UNICODE_STRING
*str
, /* [I] Unicode string to be converted */
1767 ULONG base
, /* [I] Number base for conversion (allowed 0, 2, 8, 10 or 16) */
1768 ULONG
*value
) /* [O] Destination for the converted value */
1770 LPWSTR lpwstr
= str
->Buffer
;
1771 USHORT CharsRemaining
= str
->Length
/ sizeof(WCHAR
);
1774 ULONG RunningTotal
= 0;
1777 while (CharsRemaining
>= 1 && *lpwstr
<= ' ') {
1782 if (CharsRemaining
>= 1) {
1783 if (*lpwstr
== '+') {
1786 } else if (*lpwstr
== '-') {
1795 if (CharsRemaining
>= 2 && lpwstr
[0] == '0') {
1796 if (lpwstr
[1] == 'b') {
1798 CharsRemaining
-= 2;
1800 } else if (lpwstr
[1] == 'o') {
1802 CharsRemaining
-= 2;
1804 } else if (lpwstr
[1] == 'x') {
1806 CharsRemaining
-= 2;
1810 } else if (base
!= 2 && base
!= 8 && base
!= 10 && base
!= 16) {
1811 return STATUS_INVALID_PARAMETER
;
1814 if (value
== NULL
) {
1815 return STATUS_ACCESS_VIOLATION
;
1818 while (CharsRemaining
>= 1) {
1819 wchCurrent
= *lpwstr
;
1820 if (wchCurrent
>= '0' && wchCurrent
<= '9') {
1821 digit
= wchCurrent
- '0';
1822 } else if (wchCurrent
>= 'A' && wchCurrent
<= 'Z') {
1823 digit
= wchCurrent
- 'A' + 10;
1824 } else if (wchCurrent
>= 'a' && wchCurrent
<= 'z') {
1825 digit
= wchCurrent
- 'a' + 10;
1829 if (digit
< 0 || digit
>= base
) {
1830 *value
= bMinus
? -RunningTotal
: RunningTotal
;
1831 return STATUS_SUCCESS
;
1834 RunningTotal
= RunningTotal
* base
+ digit
;
1839 *value
= bMinus
? -RunningTotal
: RunningTotal
;
1840 return STATUS_SUCCESS
;
1844 /**************************************************************************
1845 * RtlIntegerToUnicodeString (NTDLL.@)
1847 * Converts an unsigned integer to a '\0' terminated unicode string.
1850 * Success: STATUS_SUCCESS. str contains the converted number
1851 * Failure: STATUS_INVALID_PARAMETER, if base is not 0, 2, 8, 10 or 16.
1852 * STATUS_BUFFER_OVERFLOW, if str is too small to hold the string
1853 * (with the '\0' termination). In this case str->Length
1854 * is set to the length, the string would have (which can
1855 * be larger than the MaximumLength).
1858 * Instead of base 0 it uses 10 as base.
1859 * If str is NULL it crashes, as the native function does.
1862 * Do not return STATUS_BUFFER_OVERFLOW when the string is long enough.
1863 * The native function does this when the string would be longer than 16
1864 * characters even when the string parameter is long enough.
1866 NTSTATUS WINAPI
RtlIntegerToUnicodeString(
1867 ULONG value
, /* [I] Value to be converted */
1868 ULONG base
, /* [I] Number base for conversion (allowed 0, 2, 8, 10 or 16) */
1869 UNICODE_STRING
*str
) /* [O] Destination for the converted value */
1877 } else if (base
!= 2 && base
!= 8 && base
!= 10 && base
!= 16) {
1878 return STATUS_INVALID_PARAMETER
;
1886 digit
= value
% base
;
1887 value
= value
/ base
;
1891 *pos
= 'A' + digit
- 10;
1893 } while (value
!= 0L);
1895 str
->Length
= (&buffer
[32] - pos
) * sizeof(WCHAR
);
1896 if (str
->Length
>= str
->MaximumLength
) {
1897 return STATUS_BUFFER_OVERFLOW
;
1899 memcpy(str
->Buffer
, pos
, str
->Length
+ sizeof(WCHAR
));
1901 return STATUS_SUCCESS
;
1905 /*************************************************************************
1906 * RtlGUIDFromString (NTDLL.@)
1908 * Convert a string representation of a GUID into a GUID.
1911 * str [I] String representation in the format "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"
1912 * guid [O] Destination for the converted GUID
1915 * Success: STATUS_SUCCESS. guid contains the converted value.
1916 * Failure: STATUS_INVALID_PARAMETER, if str is not in the expected format.
1919 * See RtlStringFromGUID.
1921 NTSTATUS WINAPI
RtlGUIDFromString(const UNICODE_STRING
*str
, GUID
* guid
)
1924 const WCHAR
*lpszCLSID
= str
->Buffer
;
1925 BYTE
* lpOut
= (BYTE
*)guid
;
1927 TRACE("(%s,%p)\n", debugstr_us(str
), guid
);
1929 /* Convert string: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
1930 * to memory: DWORD... WORD WORD BYTES............
1937 if (*lpszCLSID
!= '{')
1938 return STATUS_INVALID_PARAMETER
;
1941 case 9: case 14: case 19: case 24:
1942 if (*lpszCLSID
!= '-')
1943 return STATUS_INVALID_PARAMETER
;
1947 if (*lpszCLSID
!= '}')
1948 return STATUS_INVALID_PARAMETER
;
1953 WCHAR ch
= *lpszCLSID
, ch2
= lpszCLSID
[1];
1956 /* Read two hex digits as a byte value */
1957 if (ch
>= '0' && ch
<= '9') ch
= ch
- '0';
1958 else if (ch
>= 'a' && ch
<= 'f') ch
= ch
- 'a' + 10;
1959 else if (ch
>= 'A' && ch
<= 'F') ch
= ch
- 'A' + 10;
1960 else return STATUS_INVALID_PARAMETER
;
1962 if (ch2
>= '0' && ch2
<= '9') ch2
= ch2
- '0';
1963 else if (ch2
>= 'a' && ch2
<= 'f') ch2
= ch2
- 'a' + 10;
1964 else if (ch2
>= 'A' && ch2
<= 'F') ch2
= ch2
- 'A' + 10;
1965 else return STATUS_INVALID_PARAMETER
;
1967 byte
= ch
<< 4 | ch2
;
1971 #ifndef WORDS_BIGENDIAN
1972 /* For Big Endian machines, we store the data such that the
1973 * dword/word members can be read as DWORDS and WORDS correctly. */
1975 case 1: lpOut
[3] = byte
; break;
1976 case 3: lpOut
[2] = byte
; break;
1977 case 5: lpOut
[1] = byte
; break;
1978 case 7: lpOut
[0] = byte
; lpOut
+= 4; break;
1980 case 10: case 15: lpOut
[1] = byte
; break;
1981 case 12: case 17: lpOut
[0] = byte
; lpOut
+= 2; break;
1984 default: lpOut
[0] = byte
; lpOut
++; break;
1986 lpszCLSID
++; /* Skip 2nd character of byte */
1994 return STATUS_SUCCESS
;
1997 /*************************************************************************
1998 * RtlStringFromGUID (NTDLL.@)
2000 * Convert a GUID into a string representation of a GUID.
2003 * guid [I] GUID to convert
2004 * str [O] Destination for the converted string
2007 * Success: STATUS_SUCCESS. str contains the converted value.
2008 * Failure: STATUS_NO_MEMORY, if memory for str cannot be allocated.
2011 * See RtlGUIDFromString.
2013 NTSTATUS WINAPI
RtlStringFromGUID(const GUID
* guid
, UNICODE_STRING
*str
)
2015 static const WCHAR szFormat
[] = { '{','%','0','8','l','X','-',
2016 '%','0','4','X','-', '%','0','4','X','-','%','0','2','X','%','0','2','X',
2017 '-', '%','0','2','X','%','0','2','X','%','0','2','X','%','0','2','X',
2018 '%','0','2','X','%','0','2','X','}','\0' };
2020 TRACE("(%p,%p)\n", guid
, str
);
2022 str
->Length
= GUID_STRING_LENGTH
* sizeof(WCHAR
);
2023 str
->MaximumLength
= str
->Length
+ sizeof(WCHAR
);
2024 str
->Buffer
= (WCHAR
*)RtlAllocateHeap(GetProcessHeap(), 0, str
->MaximumLength
);
2027 str
->Length
= str
->MaximumLength
= 0;
2028 return STATUS_NO_MEMORY
;
2030 sprintfW(str
->Buffer
, szFormat
, guid
->Data1
, guid
->Data2
, guid
->Data3
,
2031 guid
->Data4
[0], guid
->Data4
[1], guid
->Data4
[2], guid
->Data4
[3],
2032 guid
->Data4
[4], guid
->Data4
[5], guid
->Data4
[6], guid
->Data4
[7]);
2034 return STATUS_SUCCESS
;