save old text color during a call of DrawCaptionTempW
[wine/kumbayo.git] / dlls / ntdll / string.c
blobebfa6fb19fa267686c141b051e88afdc87a1c4a0
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 * atoi (NTDLL.@)
470 int __cdecl NTDLL_atoi( const char *nptr )
472 return atoi( nptr );
476 /*********************************************************************
477 * atol (NTDLL.@)
479 LONG __cdecl NTDLL_atol( const char *nptr )
481 return atol( nptr );
485 /*********************************************************************
486 * _ultoa (NTDLL.@)
488 * Convert an unsigned long integer to a string.
490 * RETURNS
491 * str.
493 * NOTES
494 * - Converts value to a Nul terminated string which is copied to str.
495 * - The maximum length of the copied str is 33 bytes.
496 * - Does not check if radix is in the range of 2 to 36.
497 * - If str is NULL it crashes, as the native function does.
499 char * __cdecl _ultoa(
500 ULONG value, /* [I] Value to be converted */
501 char *str, /* [O] Destination for the converted value */
502 int radix) /* [I] Number base for conversion */
504 char buffer[33];
505 char *pos;
506 int digit;
508 pos = &buffer[32];
509 *pos = '\0';
511 do {
512 digit = value % radix;
513 value = value / radix;
514 if (digit < 10) {
515 *--pos = '0' + digit;
516 } else {
517 *--pos = 'a' + digit - 10;
518 } /* if */
519 } while (value != 0L);
521 memcpy(str, pos, &buffer[32] - pos + 1);
522 return str;
526 /*********************************************************************
527 * _ltoa (NTDLL.@)
529 * Convert a long integer to a string.
531 * RETURNS
532 * str.
534 * NOTES
535 * - Converts value to a Nul terminated string which is copied to str.
536 * - The maximum length of the copied str is 33 bytes. If radix
537 * is 10 and value is negative, the value is converted with sign.
538 * - Does not check if radix is in the range of 2 to 36.
539 * - If str is NULL it crashes, as the native function does.
541 char * __cdecl _ltoa(
542 LONG value, /* [I] Value to be converted */
543 char *str, /* [O] Destination for the converted value */
544 int radix) /* [I] Number base for conversion */
546 ULONG val;
547 int negative;
548 char buffer[33];
549 char *pos;
550 int digit;
552 if (value < 0 && radix == 10) {
553 negative = 1;
554 val = -value;
555 } else {
556 negative = 0;
557 val = value;
558 } /* if */
560 pos = &buffer[32];
561 *pos = '\0';
563 do {
564 digit = val % radix;
565 val = val / radix;
566 if (digit < 10) {
567 *--pos = '0' + digit;
568 } else {
569 *--pos = 'a' + digit - 10;
570 } /* if */
571 } while (val != 0L);
573 if (negative) {
574 *--pos = '-';
575 } /* if */
577 memcpy(str, pos, &buffer[32] - pos + 1);
578 return str;
582 /*********************************************************************
583 * _itoa (NTDLL.@)
585 * Converts an integer to a string.
587 * RETURNS
588 * str.
590 * NOTES
591 * - Converts value to a '\0' terminated string which is copied to str.
592 * - The maximum length of the copied str is 33 bytes. If radix
593 * is 10 and value is negative, the value is converted with sign.
594 * - Does not check if radix is in the range of 2 to 36.
595 * - If str is NULL it crashes, as the native function does.
597 char * __cdecl _itoa(
598 int value, /* [I] Value to be converted */
599 char *str, /* [O] Destination for the converted value */
600 int radix) /* [I] Number base for conversion */
602 return _ltoa(value, str, radix);
606 /*********************************************************************
607 * _ui64toa (NTDLL.@)
609 * Converts a large unsigned integer to a string.
611 * RETURNS
612 * str.
614 * NOTES
615 * - Converts value to a '\0' terminated string which is copied to str.
616 * - The maximum length of the copied str is 65 bytes.
617 * - Does not check if radix is in the range of 2 to 36.
618 * - If str is NULL it crashes, as the native function does.
620 char * __cdecl _ui64toa(
621 ULONGLONG value, /* [I] Value to be converted */
622 char *str, /* [O] Destination for the converted value */
623 int radix) /* [I] Number base for conversion */
625 char buffer[65];
626 char *pos;
627 int digit;
629 pos = &buffer[64];
630 *pos = '\0';
632 do {
633 digit = value % radix;
634 value = value / radix;
635 if (digit < 10) {
636 *--pos = '0' + digit;
637 } else {
638 *--pos = 'a' + digit - 10;
639 } /* if */
640 } while (value != 0L);
642 memcpy(str, pos, &buffer[64] - pos + 1);
643 return str;
647 /*********************************************************************
648 * _i64toa (NTDLL.@)
650 * Converts a large integer to a string.
652 * RETURNS
653 * str.
655 * NOTES
656 * - Converts value to a Nul terminated string which is copied to str.
657 * - The maximum length of the copied str is 65 bytes. If radix
658 * is 10 and value is negative, the value is converted with sign.
659 * - Does not check if radix is in the range of 2 to 36.
660 * - If str is NULL it crashes, as the native function does.
662 * DIFFERENCES
663 * - The native DLL converts negative values (for base 10) wrong:
664 *| -1 is converted to -18446744073709551615
665 *| -2 is converted to -18446744073709551614
666 *| -9223372036854775807 is converted to -9223372036854775809
667 *| -9223372036854775808 is converted to -9223372036854775808
668 * The native msvcrt _i64toa function and our ntdll _i64toa function
669 * do not have this bug.
671 char * __cdecl _i64toa(
672 LONGLONG value, /* [I] Value to be converted */
673 char *str, /* [O] Destination for the converted value */
674 int radix) /* [I] Number base for conversion */
676 ULONGLONG val;
677 int negative;
678 char buffer[65];
679 char *pos;
680 int digit;
682 if (value < 0 && radix == 10) {
683 negative = 1;
684 val = -value;
685 } else {
686 negative = 0;
687 val = value;
688 } /* if */
690 pos = &buffer[64];
691 *pos = '\0';
693 do {
694 digit = val % radix;
695 val = val / radix;
696 if (digit < 10) {
697 *--pos = '0' + digit;
698 } else {
699 *--pos = 'a' + digit - 10;
700 } /* if */
701 } while (val != 0L);
703 if (negative) {
704 *--pos = '-';
705 } /* if */
707 memcpy(str, pos, &buffer[64] - pos + 1);
708 return str;
712 /*********************************************************************
713 * _atoi64 (NTDLL.@)
715 * Convert a string to a large integer.
717 * PARAMS
718 * str [I] String to be converted
720 * RETURNS
721 * Success: The integer value represented by str.
722 * Failure: 0. Note that this cannot be distinguished from a successful
723 * return, if the string contains "0".
725 * NOTES
726 * - Accepts: {whitespace} [+|-] {digits}
727 * - No check is made for value overflow, only the lower 64 bits are assigned.
728 * - If str is NULL it crashes, as the native function does.
730 LONGLONG __cdecl _atoi64( char *str )
732 ULONGLONG RunningTotal = 0;
733 char bMinus = 0;
735 while (*str == ' ' || (*str >= '\011' && *str <= '\015')) {
736 str++;
737 } /* while */
739 if (*str == '+') {
740 str++;
741 } else if (*str == '-') {
742 bMinus = 1;
743 str++;
744 } /* if */
746 while (*str >= '0' && *str <= '9') {
747 RunningTotal = RunningTotal * 10 + *str - '0';
748 str++;
749 } /* while */
751 return bMinus ? -RunningTotal : RunningTotal;
755 /*********************************************************************
756 * sprintf (NTDLL.@)
758 int __cdecl NTDLL_sprintf( char *str, const char *format, ... )
760 int ret;
761 va_list valist;
762 va_start( valist, format );
763 ret = vsprintf( str, format, valist );
764 va_end( valist );
765 return ret;
769 /*********************************************************************
770 * vsprintf (NTDLL.@)
772 int __cdecl NTDLL_vsprintf( char *str, const char *format, 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 va_list valist;
785 va_start( valist, format );
786 ret = vsnprintf( str, len, format, valist );
787 va_end( valist );
788 return ret;
792 /*********************************************************************
793 * _vsnprintf (NTDLL.@)
795 int __cdecl _vsnprintf( char *str, size_t len, const char *format, 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 va_list valist;
808 va_start( valist, format );
809 ret = vsscanf( str, format, valist );
810 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 );