dlls: Fix va_list -> ms_va_list for variadic api calls
[wine/wine64.git] / dlls / ntdll / string.c
blobf97c948a76571f8e4e8a55dd7ba5dfe7514da8c6
1 /*
2 * NTDLL string functions
4 * Copyright 2000 Alexandre Julliard
5 * Copyright 2000 Jon Griffiths
6 * Copyright 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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 #include "config.h"
24 #include "wine/port.h"
26 #include <ctype.h>
27 #include <stdarg.h>
28 #include <stdlib.h>
29 #include <stdio.h>
30 #include <string.h>
31 #include <search.h>
33 #include "windef.h"
34 #include "winternl.h"
37 /*********************************************************************
38 * memchr (NTDLL.@)
40 void * __cdecl NTDLL_memchr( const void *ptr, int c, size_t n )
42 return memchr( ptr, c, n );
46 /*********************************************************************
47 * memcmp (NTDLL.@)
49 int __cdecl NTDLL_memcmp( const void *ptr1, const void *ptr2, size_t n )
51 return memcmp( ptr1, ptr2, n );
55 /*********************************************************************
56 * memcpy (NTDLL.@)
58 * NOTES
59 * Behaves like memmove.
61 void * __cdecl NTDLL_memcpy( void *dst, const void *src, size_t n )
63 return memmove( dst, src, n );
67 /*********************************************************************
68 * memmove (NTDLL.@)
70 void * __cdecl NTDLL_memmove( void *dst, const void *src, size_t n )
72 return memmove( dst, src, n );
76 /*********************************************************************
77 * memset (NTDLL.@)
79 void * __cdecl NTDLL_memset( void *dst, int c, size_t n )
81 return memset( dst, c, n );
85 /*********************************************************************
86 * bsearch (NTDLL.@)
88 void * __cdecl NTDLL_bsearch( const void *key, const void *base, size_t nmemb,
89 size_t size, int (*compar)(const void *, const void *) )
91 return bsearch( key, base, nmemb, size, compar );
95 /*********************************************************************
96 * qsort (NTDLL.@)
98 void __cdecl NTDLL_qsort( void *base, size_t nmemb, size_t size,
99 int(*compar)(const void *, const void *) )
101 qsort( base, nmemb, size, compar );
105 /*********************************************************************
106 * _lfind (NTDLL.@)
108 void * __cdecl _lfind( const void *key, const void *base, unsigned int *nmemb,
109 size_t size, int(*compar)(const void *, const void *) )
111 size_t n = *nmemb;
112 return lfind( key, base, &n, size, compar );
116 /*********************************************************************
117 * strcat (NTDLL.@)
119 char * __cdecl NTDLL_strcat( char *dst, const char *src )
121 return strcat( dst, src );
125 /*********************************************************************
126 * strchr (NTDLL.@)
128 char * __cdecl NTDLL_strchr( const char *str, int c )
130 return strchr( str, c );
134 /*********************************************************************
135 * strcmp (NTDLL.@)
137 int __cdecl NTDLL_strcmp( const char *str1, const char *str2 )
139 return strcmp( str1, str2 );
143 /*********************************************************************
144 * strcpy (NTDLL.@)
146 char * __cdecl NTDLL_strcpy( char *dst, const char *src )
148 return strcpy( dst, src );
152 /*********************************************************************
153 * strcspn (NTDLL.@)
155 size_t __cdecl NTDLL_strcspn( const char *str, const char *reject )
157 return strcspn( str, reject );
161 /*********************************************************************
162 * strlen (NTDLL.@)
164 size_t __cdecl NTDLL_strlen( const char *str )
166 return strlen( str );
170 /*********************************************************************
171 * strncat (NTDLL.@)
173 char * __cdecl NTDLL_strncat( char *dst, const char *src, size_t len )
175 return strncat( dst, src, len );
179 /*********************************************************************
180 * strncmp (NTDLL.@)
182 int __cdecl NTDLL_strncmp( const char *str1, const char *str2, size_t len )
184 return strncmp( str1, str2, len );
188 /*********************************************************************
189 * strncpy (NTDLL.@)
191 char * __cdecl NTDLL_strncpy( char *dst, const char *src, size_t len )
193 return strncpy( dst, src, len );
197 /*********************************************************************
198 * strpbrk (NTDLL.@)
200 char * __cdecl NTDLL_strpbrk( const char *str, const char *accept )
202 return strpbrk( str, accept );
206 /*********************************************************************
207 * strrchr (NTDLL.@)
209 char * __cdecl NTDLL_strrchr( const char *str, int c )
211 return strrchr( str, c );
215 /*********************************************************************
216 * strspn (NTDLL.@)
218 size_t __cdecl NTDLL_strspn( const char *str, const char *accept )
220 return strspn( str, accept );
224 /*********************************************************************
225 * strstr (NTDLL.@)
227 char * __cdecl NTDLL_strstr( const char *haystack, const char *needle )
229 return strstr( haystack, needle );
233 /*********************************************************************
234 * _memccpy (NTDLL.@)
236 void * __cdecl _memccpy( void *dst, const void *src, int c, size_t n )
238 return memccpy( dst, src, c, n );
242 /*********************************************************************
243 * _memicmp (NTDLL.@)
245 * Compare two blocks of memory as strings, ignoring case.
247 * PARAMS
248 * s1 [I] First string to compare to s2
249 * s2 [I] Second string to compare to s1
250 * len [I] Number of bytes to compare
252 * RETURNS
253 * An integer less than, equal to, or greater than zero indicating that
254 * s1 is less than, equal to or greater than s2 respectively.
256 * NOTES
257 * Any Nul characters in s1 or s2 are ignored. This function always
258 * compares up to len bytes or the first place where s1 and s2 differ.
260 INT __cdecl _memicmp( LPCSTR s1, LPCSTR s2, DWORD len )
262 int ret = 0;
263 while (len--)
265 if ((ret = tolower(*s1) - tolower(*s2))) break;
266 s1++;
267 s2++;
269 return ret;
273 /*********************************************************************
274 * _stricmp (NTDLL.@)
275 * _strcmpi (NTDLL.@)
277 int __cdecl _stricmp( LPCSTR str1, LPCSTR str2 )
279 return strcasecmp( str1, str2 );
283 /*********************************************************************
284 * _strnicmp (NTDLL.@)
286 int __cdecl _strnicmp( LPCSTR str1, LPCSTR str2, size_t n )
288 return strncasecmp( str1, str2, n );
292 /*********************************************************************
293 * _strupr (NTDLL.@)
295 * Convert a string to upper case.
297 * PARAMS
298 * str [I/O] String to convert
300 * RETURNS
301 * str. There is no error return, if str is NULL or invalid, this
302 * function will crash.
304 LPSTR __cdecl _strupr( LPSTR str )
306 LPSTR ret = str;
307 for ( ; *str; str++) *str = toupper(*str);
308 return ret;
312 /*********************************************************************
313 * _strlwr (NTDLL.@)
315 * Convert a string to lowercase
317 * PARAMS
318 * str [I/O] String to convert
320 * RETURNS
321 * str. There is no error return, if str is NULL or invalid, this
322 * function will crash.
324 LPSTR __cdecl _strlwr( LPSTR str )
326 LPSTR ret = str;
327 for ( ; *str; str++) *str = tolower(*str);
328 return ret;
332 /*********************************************************************
333 * tolower (NTDLL.@)
335 int __cdecl NTDLL_tolower( int c )
337 return tolower( c );
341 /*********************************************************************
342 * toupper (NTDLL.@)
344 int __cdecl NTDLL_toupper( int c )
346 return toupper( c );
350 /*********************************************************************
351 * isalnum (NTDLL.@)
353 int __cdecl NTDLL_isalnum( int c )
355 return isalnum( c );
359 /*********************************************************************
360 * isalpha (NTDLL.@)
362 int __cdecl NTDLL_isalpha( int c )
364 return isalpha( c );
368 /*********************************************************************
369 * iscntrl (NTDLL.@)
371 int __cdecl NTDLL_iscntrl( int c )
373 return iscntrl( c );
377 /*********************************************************************
378 * isdigit (NTDLL.@)
380 int __cdecl NTDLL_isdigit( int c )
382 return isdigit( c );
386 /*********************************************************************
387 * isgraph (NTDLL.@)
389 int __cdecl NTDLL_isgraph( int c )
391 return isgraph( c );
395 /*********************************************************************
396 * islower (NTDLL.@)
398 int __cdecl NTDLL_islower( int c )
400 return islower( c );
404 /*********************************************************************
405 * isprint (NTDLL.@)
407 int __cdecl NTDLL_isprint( int c )
409 return isprint( c );
413 /*********************************************************************
414 * ispunct (NTDLL.@)
416 int __cdecl NTDLL_ispunct( int c )
418 return ispunct( c );
422 /*********************************************************************
423 * isspace (NTDLL.@)
425 int __cdecl NTDLL_isspace( int c )
427 return isspace( c );
431 /*********************************************************************
432 * isupper (NTDLL.@)
434 int __cdecl NTDLL_isupper( int c )
436 return isupper( c );
440 /*********************************************************************
441 * isxdigit (NTDLL.@)
443 int __cdecl NTDLL_isxdigit( int c )
445 return isxdigit( c );
449 /*********************************************************************
450 * strtol (NTDLL.@)
452 LONG __cdecl NTDLL_strtol( const char *nptr, char **endptr, int base )
454 return strtol( nptr, endptr, base );
458 /*********************************************************************
459 * strtoul (NTDLL.@)
461 ULONG __cdecl NTDLL_strtoul( const char *nptr, char **endptr, int base )
463 return strtoul( nptr, endptr, base );
467 /*********************************************************************
468 * _ultoa (NTDLL.@)
470 * Convert an unsigned long integer to a string.
472 * RETURNS
473 * str.
475 * NOTES
476 * - Converts value to a Nul terminated string which is copied to str.
477 * - The maximum length of the copied str is 33 bytes.
478 * - Does not check if radix is in the range of 2 to 36.
479 * - If str is NULL it crashes, as the native function does.
481 char * __cdecl _ultoa(
482 ULONG value, /* [I] Value to be converted */
483 char *str, /* [O] Destination for the converted value */
484 int radix) /* [I] Number base for conversion */
486 char buffer[33];
487 char *pos;
488 int digit;
490 pos = &buffer[32];
491 *pos = '\0';
493 do {
494 digit = value % radix;
495 value = value / radix;
496 if (digit < 10) {
497 *--pos = '0' + digit;
498 } else {
499 *--pos = 'a' + digit - 10;
500 } /* if */
501 } while (value != 0L);
503 memcpy(str, pos, &buffer[32] - pos + 1);
504 return str;
508 /*********************************************************************
509 * _ltoa (NTDLL.@)
511 * Convert a long integer to a string.
513 * RETURNS
514 * str.
516 * NOTES
517 * - Converts value to a Nul terminated string which is copied to str.
518 * - The maximum length of the copied str is 33 bytes. If radix
519 * is 10 and value is negative, the value is converted with sign.
520 * - Does not check if radix is in the range of 2 to 36.
521 * - If str is NULL it crashes, as the native function does.
523 char * __cdecl _ltoa(
524 LONG value, /* [I] Value to be converted */
525 char *str, /* [O] Destination for the converted value */
526 int radix) /* [I] Number base for conversion */
528 ULONG val;
529 int negative;
530 char buffer[33];
531 char *pos;
532 int digit;
534 if (value < 0 && radix == 10) {
535 negative = 1;
536 val = -value;
537 } else {
538 negative = 0;
539 val = value;
540 } /* if */
542 pos = &buffer[32];
543 *pos = '\0';
545 do {
546 digit = val % radix;
547 val = val / radix;
548 if (digit < 10) {
549 *--pos = '0' + digit;
550 } else {
551 *--pos = 'a' + digit - 10;
552 } /* if */
553 } while (val != 0L);
555 if (negative) {
556 *--pos = '-';
557 } /* if */
559 memcpy(str, pos, &buffer[32] - pos + 1);
560 return str;
564 /*********************************************************************
565 * _itoa (NTDLL.@)
567 * Converts an integer to a string.
569 * RETURNS
570 * str.
572 * NOTES
573 * - Converts value to a '\0' terminated string which is copied to str.
574 * - The maximum length of the copied str is 33 bytes. If radix
575 * is 10 and value is negative, the value is converted with sign.
576 * - Does not check if radix is in the range of 2 to 36.
577 * - If str is NULL it crashes, as the native function does.
579 char * __cdecl _itoa(
580 int value, /* [I] Value to be converted */
581 char *str, /* [O] Destination for the converted value */
582 int radix) /* [I] Number base for conversion */
584 return _ltoa(value, str, radix);
588 /*********************************************************************
589 * _ui64toa (NTDLL.@)
591 * Converts a large unsigned integer to a string.
593 * RETURNS
594 * str.
596 * NOTES
597 * - Converts value to a '\0' terminated string which is copied to str.
598 * - The maximum length of the copied str is 65 bytes.
599 * - Does not check if radix is in the range of 2 to 36.
600 * - If str is NULL it crashes, as the native function does.
602 char * __cdecl _ui64toa(
603 ULONGLONG value, /* [I] Value to be converted */
604 char *str, /* [O] Destination for the converted value */
605 int radix) /* [I] Number base for conversion */
607 char buffer[65];
608 char *pos;
609 int digit;
611 pos = &buffer[64];
612 *pos = '\0';
614 do {
615 digit = value % radix;
616 value = value / radix;
617 if (digit < 10) {
618 *--pos = '0' + digit;
619 } else {
620 *--pos = 'a' + digit - 10;
621 } /* if */
622 } while (value != 0L);
624 memcpy(str, pos, &buffer[64] - pos + 1);
625 return str;
629 /*********************************************************************
630 * _i64toa (NTDLL.@)
632 * Converts a large integer to a string.
634 * RETURNS
635 * str.
637 * NOTES
638 * - Converts value to a Nul terminated string which is copied to str.
639 * - The maximum length of the copied str is 65 bytes. If radix
640 * is 10 and value is negative, the value is converted with sign.
641 * - Does not check if radix is in the range of 2 to 36.
642 * - If str is NULL it crashes, as the native function does.
644 * DIFFERENCES
645 * - The native DLL converts negative values (for base 10) wrong:
646 *| -1 is converted to -18446744073709551615
647 *| -2 is converted to -18446744073709551614
648 *| -9223372036854775807 is converted to -9223372036854775809
649 *| -9223372036854775808 is converted to -9223372036854775808
650 * The native msvcrt _i64toa function and our ntdll _i64toa function
651 * do not have this bug.
653 char * __cdecl _i64toa(
654 LONGLONG value, /* [I] Value to be converted */
655 char *str, /* [O] Destination for the converted value */
656 int radix) /* [I] Number base for conversion */
658 ULONGLONG val;
659 int negative;
660 char buffer[65];
661 char *pos;
662 int digit;
664 if (value < 0 && radix == 10) {
665 negative = 1;
666 val = -value;
667 } else {
668 negative = 0;
669 val = value;
670 } /* if */
672 pos = &buffer[64];
673 *pos = '\0';
675 do {
676 digit = val % radix;
677 val = val / radix;
678 if (digit < 10) {
679 *--pos = '0' + digit;
680 } else {
681 *--pos = 'a' + digit - 10;
682 } /* if */
683 } while (val != 0L);
685 if (negative) {
686 *--pos = '-';
687 } /* if */
689 memcpy(str, pos, &buffer[64] - pos + 1);
690 return str;
694 /*********************************************************************
695 * _atoi64 (NTDLL.@)
697 * Convert a string to a large integer.
699 * PARAMS
700 * str [I] String to be converted
702 * RETURNS
703 * Success: The integer value represented by str.
704 * Failure: 0. Note that this cannot be distinguished from a successful
705 * return, if the string contains "0".
707 * NOTES
708 * - Accepts: {whitespace} [+|-] {digits}
709 * - No check is made for value overflow, only the lower 64 bits are assigned.
710 * - If str is NULL it crashes, as the native function does.
712 LONGLONG __cdecl _atoi64( const char *str )
714 ULONGLONG RunningTotal = 0;
715 char bMinus = 0;
717 while (*str == ' ' || (*str >= '\011' && *str <= '\015')) {
718 str++;
719 } /* while */
721 if (*str == '+') {
722 str++;
723 } else if (*str == '-') {
724 bMinus = 1;
725 str++;
726 } /* if */
728 while (*str >= '0' && *str <= '9') {
729 RunningTotal = RunningTotal * 10 + *str - '0';
730 str++;
731 } /* while */
733 return bMinus ? -RunningTotal : RunningTotal;
737 /*********************************************************************
738 * atoi (NTDLL.@)
740 int __cdecl NTDLL_atoi( const char *nptr )
742 return _atoi64( nptr );
746 /*********************************************************************
747 * atol (NTDLL.@)
749 LONG __cdecl NTDLL_atol( const char *nptr )
751 return _atoi64( nptr );
755 /*********************************************************************
756 * sprintf (NTDLL.@)
758 int __cdecl NTDLL_sprintf( char *str, const char *format, ... )
760 int ret;
761 ms_va_list valist;
762 ms_va_start( valist, format );
763 ret = vsprintf( str, format, valist );
764 ms_va_end( valist );
765 return ret;
769 /*********************************************************************
770 * vsprintf (NTDLL.@)
772 int __cdecl NTDLL_vsprintf( char *str, const char *format, ms_va_list args )
774 return vsprintf( str, format, args );
778 /*********************************************************************
779 * _snprintf (NTDLL.@)
781 int __cdecl _snprintf( char *str, size_t len, const char *format, ... )
783 int ret;
784 ms_va_list valist;
785 ms_va_start( valist, format );
786 ret = vsnprintf( str, len, format, valist );
787 ms_va_end( valist );
788 return ret;
792 /*********************************************************************
793 * _vsnprintf (NTDLL.@)
795 int __cdecl _vsnprintf( char *str, size_t len, const char *format, ms_va_list args )
797 return vsnprintf( str, len, format, args );
801 /*********************************************************************
802 * sscanf (NTDLL.@)
804 int __cdecl NTDLL_sscanf( const char *str, const char *format, ... )
806 int ret;
807 ms_va_list valist;
808 ms_va_start( valist, format );
809 ret = vsscanf( str, format, valist );
810 ms_va_end( valist );
811 return ret;
815 /*********************************************************************
816 * _splitpath (NTDLL.@)
818 * Split a path into its component pieces.
820 * PARAMS
821 * inpath [I] Path to split
822 * drv [O] Destination for drive component (e.g. "A:"). Must be at least 3 characters.
823 * dir [O] Destination for directory component. Should be at least MAX_PATH characters.
824 * fname [O] Destination for File name component. Should be at least MAX_PATH characters.
825 * ext [O] Destination for file extension component. Should be at least MAX_PATH characters.
827 * RETURNS
828 * Nothing.
830 void __cdecl _splitpath(const char* inpath, char * drv, char * dir,
831 char* fname, char * ext )
833 const char *p, *end;
835 if (inpath[0] && inpath[1] == ':')
837 if (drv)
839 drv[0] = inpath[0];
840 drv[1] = inpath[1];
841 drv[2] = 0;
843 inpath += 2;
845 else if (drv) drv[0] = 0;
847 /* look for end of directory part */
848 end = NULL;
849 for (p = inpath; *p; p++) if (*p == '/' || *p == '\\') end = p + 1;
851 if (end) /* got a directory */
853 if (dir)
855 memcpy( dir, inpath, end - inpath );
856 dir[end - inpath] = 0;
858 inpath = end;
860 else if (dir) dir[0] = 0;
862 /* look for extension: what's after the last dot */
863 end = NULL;
864 for (p = inpath; *p; p++) if (*p == '.') end = p;
866 if (!end) end = p; /* there's no extension */
868 if (fname)
870 memcpy( fname, inpath, end - inpath );
871 fname[end - inpath] = 0;
873 if (ext) strcpy( ext, end );