2 * general implementation of scanf used by scanf, sscanf, fscanf,
3 * _cscanf, wscanf, swscanf and fwscanf
5 * Copyright 1996,1998 Marcus Meissner
6 * Copyright 1996 Jukka Iivonen
7 * Copyright 1997,2000 Uwe Bonnes
8 * Copyright 2000 Jon Griffiths
9 * Copyright 2002 Daniel Gudbjartsson
11 * This library is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU Lesser General Public
13 * License as published by the Free Software Foundation; either
14 * version 2.1 of the License, or (at your option) any later version.
16 * This library is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 * Lesser General Public License for more details.
21 * You should have received a copy of the GNU Lesser General Public
22 * License along with this library; if not, write to the Free Software
23 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
34 #include "wine/debug.h"
36 WINE_DEFAULT_DEBUG_CHANNEL(msvcrt
);
38 /* helper function for *scanf. Returns the value of character c in the
39 * given base, or -1 if the given character is not a digit of the base.
41 static int char2digit(char c
, int base
) {
42 if ((c
>='0') && (c
<='9') && (c
<='0'+base
-1)) return (c
-'0');
43 if (base
<=10) return -1;
44 if ((c
>='A') && (c
<='Z') && (c
<='A'+base
-11)) return (c
-'A'+10);
45 if ((c
>='a') && (c
<='z') && (c
<='a'+base
-11)) return (c
-'a'+10);
49 /* helper function for *wscanf. Returns the value of character c in the
50 * given base, or -1 if the given character is not a digit of the base.
52 static int wchar2digit(MSVCRT_wchar_t c
, int base
) {
53 if ((c
>='0') && (c
<='9') && (c
<='0'+base
-1)) return (c
-'0');
54 if (base
<=10) return -1;
55 if ((c
>='A') && (c
<='Z') && (c
<='A'+base
-11)) return (c
-'A'+10);
56 if ((c
>='a') && (c
<='z') && (c
<='a'+base
-11)) return (c
-'a'+10);
146 /*********************************************************************
149 int WINAPIV
MSVCRT_fscanf(MSVCRT_FILE
*file
, const char *format
, ...)
154 __ms_va_start(valist
, format
);
155 res
= MSVCRT_vfscanf_l(file
, format
, NULL
, valist
);
160 /*********************************************************************
161 * _fscanf_l (MSVCRT.@)
163 int WINAPIV
MSVCRT__fscanf_l(MSVCRT_FILE
*file
, const char *format
,
164 MSVCRT__locale_t locale
, ...)
169 __ms_va_start(valist
, locale
);
170 res
= MSVCRT_vfscanf_l(file
, format
, locale
, valist
);
175 /*********************************************************************
176 * fscanf_s (MSVCRT.@)
178 int WINAPIV
MSVCRT_fscanf_s(MSVCRT_FILE
*file
, const char *format
, ...)
183 __ms_va_start(valist
, format
);
184 res
= MSVCRT_vfscanf_s_l(file
, format
, NULL
, valist
);
189 /*********************************************************************
190 * _fscanf_s_l (MSVCRT.@)
192 int WINAPIV
MSVCRT__fscanf_s_l(MSVCRT_FILE
*file
, const char *format
,
193 MSVCRT__locale_t locale
, ...)
198 __ms_va_start(valist
, locale
);
199 res
= MSVCRT_vfscanf_s_l(file
, format
, locale
, valist
);
204 /*********************************************************************
207 int WINAPIV
MSVCRT_scanf(const char *format
, ...)
212 __ms_va_start(valist
, format
);
213 res
= MSVCRT_vfscanf_l(MSVCRT_stdin
, format
, NULL
, valist
);
218 /*********************************************************************
219 * _scanf_l (MSVCRT.@)
221 int WINAPIV
MSVCRT__scanf_l(const char *format
, MSVCRT__locale_t locale
, ...)
226 __ms_va_start(valist
, locale
);
227 res
= MSVCRT_vfscanf_l(MSVCRT_stdin
, format
, locale
, valist
);
232 /*********************************************************************
235 int WINAPIV
MSVCRT_scanf_s(const char *format
, ...)
240 __ms_va_start(valist
, format
);
241 res
= MSVCRT_vfscanf_s_l(MSVCRT_stdin
, format
, NULL
, valist
);
246 /*********************************************************************
247 * _scanf_s_l (MSVCRT.@)
249 int WINAPIV
MSVCRT__scanf_s_l(const char *format
, MSVCRT__locale_t locale
, ...)
254 __ms_va_start(valist
, locale
);
255 res
= MSVCRT_vfscanf_s_l(MSVCRT_stdin
, format
, locale
, valist
);
260 /*********************************************************************
263 int WINAPIV
MSVCRT_fwscanf(MSVCRT_FILE
*file
, const MSVCRT_wchar_t
*format
, ...)
268 __ms_va_start(valist
, format
);
269 res
= MSVCRT_vfwscanf_l(file
, format
, NULL
, valist
);
274 /*********************************************************************
275 * _fwscanf_l (MSVCRT.@)
277 int WINAPIV
MSVCRT__fwscanf_l(MSVCRT_FILE
*file
, const MSVCRT_wchar_t
*format
,
278 MSVCRT__locale_t locale
, ...)
283 __ms_va_start(valist
, locale
);
284 res
= MSVCRT_vfwscanf_l(file
, format
, locale
, valist
);
289 /*********************************************************************
290 * fwscanf_s (MSVCRT.@)
292 int WINAPIV
MSVCRT_fwscanf_s(MSVCRT_FILE
*file
, const MSVCRT_wchar_t
*format
, ...)
297 __ms_va_start(valist
, format
);
298 res
= MSVCRT_vfwscanf_s_l(file
, format
, NULL
, valist
);
303 /*********************************************************************
304 * _fwscanf_s_l (MSVCRT.@)
306 int WINAPIV
MSVCRT__fwscanf_s_l(MSVCRT_FILE
*file
, const MSVCRT_wchar_t
*format
,
307 MSVCRT__locale_t locale
, ...)
312 __ms_va_start(valist
, locale
);
313 res
= MSVCRT_vfwscanf_s_l(file
, format
, locale
, valist
);
318 /*********************************************************************
321 int WINAPIV
MSVCRT_wscanf(const MSVCRT_wchar_t
*format
, ...)
326 __ms_va_start(valist
, format
);
327 res
= MSVCRT_vfwscanf_l(MSVCRT_stdin
, format
, NULL
, valist
);
332 /*********************************************************************
333 * _wscanf_l (MSVCRT.@)
335 int WINAPIV
MSVCRT__wscanf_l(const MSVCRT_wchar_t
*format
,
336 MSVCRT__locale_t locale
, ...)
341 __ms_va_start(valist
, locale
);
342 res
= MSVCRT_vfwscanf_l(MSVCRT_stdin
, format
, locale
, valist
);
347 /*********************************************************************
348 * wscanf_s (MSVCRT.@)
350 int WINAPIV
MSVCRT_wscanf_s(const MSVCRT_wchar_t
*format
, ...)
355 __ms_va_start(valist
, format
);
356 res
= MSVCRT_vfwscanf_s_l(MSVCRT_stdin
, format
, NULL
, valist
);
361 /*********************************************************************
362 * _wscanf_s_l (MSVCRT.@)
364 int WINAPIV
MSVCRT__wscanf_s_l(const MSVCRT_wchar_t
*format
,
365 MSVCRT__locale_t locale
, ...)
370 __ms_va_start(valist
, locale
);
371 res
= MSVCRT_vfwscanf_s_l(MSVCRT_stdin
, format
, locale
, valist
);
376 /*********************************************************************
379 int WINAPIV
MSVCRT_sscanf(const char *str
, const char *format
, ...)
384 __ms_va_start(valist
, format
);
385 res
= MSVCRT_vsscanf_l(str
, format
, NULL
, valist
);
390 /*********************************************************************
391 * _sscanf_l (MSVCRT.@)
393 int WINAPIV
MSVCRT__sscanf_l(const char *str
, const char *format
,
394 MSVCRT__locale_t locale
, ...)
399 __ms_va_start(valist
, locale
);
400 res
= MSVCRT_vsscanf_l(str
, format
, locale
, valist
);
405 /*********************************************************************
406 * sscanf_s (MSVCRT.@)
408 int WINAPIV
MSVCRT_sscanf_s(const char *str
, const char *format
, ...)
413 __ms_va_start(valist
, format
);
414 res
= MSVCRT_vsscanf_s_l(str
, format
, NULL
, valist
);
419 /*********************************************************************
420 * _sscanf_s_l (MSVCRT.@)
422 int WINAPIV
MSVCRT__sscanf_s_l(const char *str
, const char *format
,
423 MSVCRT__locale_t locale
, ...)
428 __ms_va_start(valist
, locale
);
429 res
= MSVCRT_vsscanf_s_l(str
, format
, locale
, valist
);
434 /*********************************************************************
437 int WINAPIV
MSVCRT_swscanf(const MSVCRT_wchar_t
*str
, const MSVCRT_wchar_t
*format
, ...)
442 __ms_va_start(valist
, format
);
443 res
= MSVCRT_vswscanf_l(str
, format
, NULL
, valist
);
448 /*********************************************************************
449 * _swscanf_l (MSVCRT.@)
451 int WINAPIV
MSVCRT__swscanf_l(const MSVCRT_wchar_t
*str
, const MSVCRT_wchar_t
*format
,
452 MSVCRT__locale_t locale
, ...)
457 __ms_va_start(valist
, locale
);
458 res
= MSVCRT_vswscanf_l(str
, format
, locale
, valist
);
463 /*********************************************************************
464 * swscanf_s (MSVCRT.@)
466 int WINAPIV
MSVCRT_swscanf_s(const MSVCRT_wchar_t
*str
, const MSVCRT_wchar_t
*format
, ...)
471 __ms_va_start(valist
, format
);
472 res
= MSVCRT_vswscanf_s_l(str
, format
, NULL
, valist
);
477 /*********************************************************************
478 * _swscanf_s_l (MSVCRT.@)
480 int WINAPIV
MSVCRT__swscanf_s_l(const MSVCRT_wchar_t
*str
, const MSVCRT_wchar_t
*format
,
481 MSVCRT__locale_t locale
, ...)
486 __ms_va_start(valist
, locale
);
487 res
= MSVCRT_vswscanf_s_l(str
, format
, locale
, valist
);
492 /*********************************************************************
495 int WINAPIV
_cscanf(const char *format
, ...)
500 __ms_va_start(valist
, format
);
501 res
= MSVCRT_vcscanf_l(format
, NULL
, valist
);
506 /*********************************************************************
507 * _cscanf_l (MSVCRT.@)
509 int WINAPIV
_cscanf_l(const char *format
, MSVCRT__locale_t locale
, ...)
514 __ms_va_start(valist
, locale
);
515 res
= MSVCRT_vcscanf_l(format
, locale
, valist
);
520 /*********************************************************************
521 * _cscanf_s (MSVCRT.@)
523 int WINAPIV
_cscanf_s(const char *format
, ...)
528 __ms_va_start(valist
, format
);
529 res
= MSVCRT_vcscanf_s_l(format
, NULL
, valist
);
534 /*********************************************************************
535 * _cscanf_s_l (MSVCRT.@)
537 int WINAPIV
_cscanf_s_l(const char *format
, MSVCRT__locale_t locale
, ...)
542 __ms_va_start(valist
, locale
);
543 res
= MSVCRT_vcscanf_s_l(format
, locale
, valist
);
548 /*********************************************************************
549 * _cwscanf (MSVCRT.@)
551 int WINAPIV
_cwscanf(const MSVCRT_wchar_t
*format
, ...)
556 __ms_va_start(valist
, format
);
557 res
= MSVCRT_vcwscanf_l(format
, NULL
, valist
);
562 /*********************************************************************
563 * _cwscanf_l (MSVCRT.@)
565 int WINAPIV
_cwscanf_l(const MSVCRT_wchar_t
*format
, MSVCRT__locale_t locale
, ...)
570 __ms_va_start(valist
, locale
);
571 res
= MSVCRT_vcwscanf_l(format
, locale
, valist
);
576 /*********************************************************************
577 * _cwscanf_s (MSVCRT.@)
579 int WINAPIV
_cwscanf_s(const MSVCRT_wchar_t
*format
, ...)
584 __ms_va_start(valist
, format
);
585 res
= MSVCRT_vcwscanf_s_l(format
, NULL
, valist
);
590 /*********************************************************************
591 * _cwscanf_s_l (MSVCRT.@)
593 int WINAPIV
_cwscanf_s_l(const MSVCRT_wchar_t
*format
, MSVCRT__locale_t locale
, ...)
598 __ms_va_start(valist
, locale
);
599 res
= MSVCRT_vcwscanf_s_l(format
, locale
, valist
);
604 /*********************************************************************
605 * _snscanf (MSVCRT.@)
607 int WINAPIV
MSVCRT__snscanf(char *input
, MSVCRT_size_t length
, const char *format
, ...)
612 __ms_va_start(valist
, format
);
613 res
= MSVCRT_vsnscanf_l(input
, length
, format
, NULL
, valist
);
618 /*********************************************************************
619 * _snscanf_l (MSVCRT.@)
621 int WINAPIV
MSVCRT__snscanf_l(char *input
, MSVCRT_size_t length
,
622 const char *format
, MSVCRT__locale_t locale
, ...)
627 __ms_va_start(valist
, locale
);
628 res
= MSVCRT_vsnscanf_l(input
, length
, format
, locale
, valist
);
633 /*********************************************************************
634 * _snscanf_s (MSVCRT.@)
636 int WINAPIV
MSVCRT__snscanf_s(char *input
, MSVCRT_size_t length
, const char *format
, ...)
641 __ms_va_start(valist
, format
);
642 res
= MSVCRT_vsnscanf_s_l(input
, length
, format
, NULL
, valist
);
647 /*********************************************************************
648 * _snscanf_s_l (MSVCRT.@)
650 int WINAPIV
MSVCRT__snscanf_s_l(char *input
, MSVCRT_size_t length
,
651 const char *format
, MSVCRT__locale_t locale
, ...)
656 __ms_va_start(valist
, locale
);
657 res
= MSVCRT_vsnscanf_s_l(input
, length
, format
, locale
, valist
);
663 /*********************************************************************
664 * __stdio_common_vsscanf (UCRTBASE.@)
666 int CDECL
MSVCRT__stdio_common_vsscanf(unsigned __int64 options
,
667 const char *input
, MSVCRT_size_t length
,
669 MSVCRT__locale_t locale
,
672 /* LEGACY_WIDE_SPECIFIERS only has got an effect on the wide
673 * scanf. LEGACY_MSVCRT_COMPATIBILITY affects parsing of nan/inf,
674 * but parsing of those isn't implemented at all yet. */
675 if (options
& ~UCRTBASE_SCANF_MASK
)
676 FIXME("options %s not handled\n", wine_dbgstr_longlong(options
));
677 if (options
& UCRTBASE_SCANF_SECURECRT
)
678 return MSVCRT_vsnscanf_s_l(input
, length
, format
, locale
, valist
);
680 return MSVCRT_vsnscanf_l(input
, length
, format
, locale
, valist
);
683 /*********************************************************************
684 * __stdio_common_vswscanf (UCRTBASE.@)
686 int CDECL
MSVCRT__stdio_common_vswscanf(unsigned __int64 options
,
687 const MSVCRT_wchar_t
*input
, MSVCRT_size_t length
,
688 const MSVCRT_wchar_t
*format
,
689 MSVCRT__locale_t locale
,
692 /* LEGACY_WIDE_SPECIFIERS only has got an effect on the wide
693 * scanf. LEGACY_MSVCRT_COMPATIBILITY affects parsing of nan/inf,
694 * but parsing of those isn't implemented at all yet. */
695 if (options
& ~UCRTBASE_SCANF_MASK
)
696 FIXME("options %s not handled\n", wine_dbgstr_longlong(options
));
697 if (options
& UCRTBASE_SCANF_SECURECRT
)
698 return MSVCRT_vsnwscanf_s_l(input
, length
, format
, locale
, valist
);
700 return MSVCRT_vsnwscanf_l(input
, length
, format
, locale
, valist
);
703 /*********************************************************************
704 * __stdio_common_vfscanf (UCRTBASE.@)
706 int CDECL
MSVCRT__stdio_common_vfscanf(unsigned __int64 options
,
709 MSVCRT__locale_t locale
,
712 if (options
& ~UCRTBASE_SCANF_SECURECRT
)
713 FIXME("options %s not handled\n", wine_dbgstr_longlong(options
));
714 if (options
& UCRTBASE_SCANF_SECURECRT
)
715 return MSVCRT_vfscanf_s_l(file
, format
, locale
, valist
);
717 return MSVCRT_vfscanf_l(file
, format
, locale
, valist
);
720 /*********************************************************************
721 * __stdio_common_vfwscanf (UCRTBASE.@)
723 int CDECL
MSVCRT__stdio_common_vfwscanf(unsigned __int64 options
,
725 const MSVCRT_wchar_t
*format
,
726 MSVCRT__locale_t locale
,
729 if (options
& ~UCRTBASE_SCANF_SECURECRT
)
730 FIXME("options %s not handled\n", wine_dbgstr_longlong(options
));
731 if (options
& UCRTBASE_SCANF_SECURECRT
)
732 return MSVCRT_vfwscanf_s_l(file
, format
, locale
, valist
);
734 return MSVCRT_vfwscanf_l(file
, format
, locale
, valist
);
737 /*********************************************************************
738 * _snwscanf (MSVCRT.@)
740 int WINAPIV
MSVCRT__snwscanf(MSVCRT_wchar_t
*input
, MSVCRT_size_t length
,
741 const MSVCRT_wchar_t
*format
, ...)
746 __ms_va_start(valist
, format
);
747 res
= MSVCRT_vsnwscanf_l(input
, length
, format
, NULL
, valist
);
752 /*********************************************************************
753 * _snwscanf_l (MSVCRT.@)
755 int WINAPIV
MSVCRT__snwscanf_l(MSVCRT_wchar_t
*input
, MSVCRT_size_t length
,
756 const MSVCRT_wchar_t
*format
, MSVCRT__locale_t locale
, ...)
761 __ms_va_start(valist
, locale
);
762 res
= MSVCRT_vsnwscanf_l(input
, length
, format
, locale
, valist
);
767 /*********************************************************************
768 * _snwscanf_s (MSVCRT.@)
770 int WINAPIV
MSVCRT__snwscanf_s(MSVCRT_wchar_t
*input
, MSVCRT_size_t length
,
771 const MSVCRT_wchar_t
*format
, ...)
776 __ms_va_start(valist
, format
);
777 res
= MSVCRT_vsnwscanf_s_l(input
, length
, format
, NULL
, valist
);
782 /*********************************************************************
783 * _snscanf_s_l (MSVCRT.@)
785 int WINAPIV
MSVCRT__snwscanf_s_l(MSVCRT_wchar_t
*input
, MSVCRT_size_t length
,
786 const MSVCRT_wchar_t
*format
, MSVCRT__locale_t locale
, ...)
791 __ms_va_start(valist
, locale
);
792 res
= MSVCRT_vsnwscanf_s_l(input
, length
, format
, locale
, valist
);
799 /*********************************************************************
800 * vsscanf (MSVCRT120.@)
802 int CDECL
MSVCRT_vsscanf(const char *buffer
, const char *format
, __ms_va_list valist
)
804 if (!MSVCRT_CHECK_PMT(buffer
!= NULL
&& format
!= NULL
)) return -1;
806 return MSVCRT_vsscanf_l(buffer
, format
, NULL
, valist
);
809 /*********************************************************************
810 * vswscanf (MSVCRT120.@)
812 int CDECL
MSVCRT_vswscanf(const MSVCRT_wchar_t
*buffer
, const MSVCRT_wchar_t
*format
, __ms_va_list valist
)
814 if (!MSVCRT_CHECK_PMT(buffer
!= NULL
&& format
!= NULL
)) return -1;
816 return MSVCRT_vswscanf_l(buffer
, format
, NULL
, valist
);
819 #endif /* _MSVCR_VER>=120 */