git.oblomov.eu Git - wine/blob - dlls/msvcrt/scanf.h

   1 /*
   2  * general implementation of scanf used by scanf, sscanf, fscanf,
   3  * _cscanf, wscanf, swscanf and fwscanf
   4  *
   5  * Copyright 1996,1998 Marcus Meissner
   6  * Copyright 1996 Jukka Iivonen
   7  * Copyright 1997,2000, 2003 Uwe Bonnes
   8  * Copyright 2000 Jon Griffiths
   9  * Copyright 2002 Daniel Gudbjartsson
  10  *
  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.
  15  *
  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.
  20  *
  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
  24  */
  25
  26 #ifdef WIDE_SCANF
  27 #define _CHAR_ MSVCRT_wchar_t
  28 #define _EOF_ MSVCRT_WEOF
  29 #define _EOF_RET (short)MSVCRT_WEOF
  30 #define _ISSPACE_(c) MSVCRT_iswspace(c)
  31 #define _ISDIGIT_(c) MSVCRT_iswdigit(c)
  32 #define _WIDE2SUPPORTED_(c) c /* No conversion needed (wide to wide) */
  33 #define _CHAR2SUPPORTED_(c) c /* FIXME: convert char to wide char */
  34 #define _CHAR2DIGIT_(c, base) wchar2digit((c), (base))
  35 #define _BITMAPSIZE_ 256*256
  36 #else /* WIDE_SCANF */
  37 #define _CHAR_ char
  38 #define _EOF_ MSVCRT_EOF
  39 #define _EOF_RET MSVCRT_EOF
  40 #define _ISSPACE_(c) isspace(c)
  41 #define _ISDIGIT_(c) isdigit(c)
  42 #define _WIDE2SUPPORTED_(c) c /* FIXME: convert wide char to char */
  43 #define _CHAR2SUPPORTED_(c) c /* No conversion needed (char to char) */
  44 #define _CHAR2DIGIT_(c, base) char2digit((c), (base))
  45 #define _BITMAPSIZE_ 256
  46 #endif /* WIDE_SCANF */
  47
  48 #ifdef CONSOLE
  49 #define _GETC_(file) (consumed++, _getch())
  50 #define _UNGETC_(nch, file) do { _ungetch(nch); consumed--; } while(0)
  51 #define _LOCK_FILE_(file) MSVCRT__lock_file(MSVCRT_stdin)
  52 #define _UNLOCK_FILE_(file) MSVCRT__unlock_file(MSVCRT_stdin)
  53 #ifdef WIDE_SCANF
  54 #ifdef SECURE
  55 #define _FUNCTION_ static int MSVCRT_vcwscanf_s_l(const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
  56 #else  /* SECURE */
  57 #define _FUNCTION_ static int MSVCRT_vcwscanf_l(const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
  58 #endif /* SECURE */
  59 #else  /* WIDE_SCANF */
  60 #ifdef SECURE
  61 #define _FUNCTION_ static int MSVCRT_vcscanf_s_l(const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
  62 #else  /* SECURE */
  63 #define _FUNCTION_ static int MSVCRT_vcscanf_l(const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
  64 #endif /* SECURE */
  65 #endif /* WIDE_SCANF */
  66 #else
  67 #ifdef STRING
  68 #undef _EOF_
  69 #define _EOF_ 0
  70 #ifdef STRING_LEN
  71 #define _GETC_(file) (consumed==length ? '\0' : (consumed++, *file++))
  72 #define _UNGETC_(nch, file) do { file--; consumed--; } while(0)
  73 #define _LOCK_FILE_(file) do {} while(0)
  74 #define _UNLOCK_FILE_(file) do {} while(0)
  75 #ifdef WIDE_SCANF
  76 #ifdef SECURE
  77 #define _FUNCTION_ static int MSVCRT_vsnwscanf_s_l(const MSVCRT_wchar_t *file, MSVCRT_size_t length, const MSVCRT_wchar_t *format, MSVCRT__locale_t locale, __ms_va_list ap)
  78 #else  /* SECURE */
  79 #define _FUNCTION_ static int MSVCRT_vsnwscanf_l(const MSVCRT_wchar_t *file, MSVCRT_size_t length, const MSVCRT_wchar_t *format, MSVCRT__locale_t locale, __ms_va_list ap)
  80 #endif /* SECURE */
  81 #else /* WIDE_SCANF */
  82 #ifdef SECURE
  83 #define _FUNCTION_ static int MSVCRT_vsnscanf_s_l(const char *file, MSVCRT_size_t length, const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
  84 #else  /* SECURE */
  85 #define _FUNCTION_ static int MSVCRT_vsnscanf_l(const char *file, MSVCRT_size_t length, const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
  86 #endif /* SECURE */
  87 #endif /* WIDE_SCANF */
  88 #else /* STRING_LEN */
  89 #define _GETC_(file) (consumed++, *file++)
  90 #define _UNGETC_(nch, file) do { file--; consumed--; } while(0)
  91 #define _LOCK_FILE_(file) do {} while(0)
  92 #define _UNLOCK_FILE_(file) do {} while(0)
  93 #ifdef WIDE_SCANF
  94 #ifdef SECURE
  95 #define _FUNCTION_ static int MSVCRT_vswscanf_s_l(const MSVCRT_wchar_t *file, const MSVCRT_wchar_t *format, MSVCRT__locale_t locale, __ms_va_list ap)
  96 #else  /* SECURE */
  97 #define _FUNCTION_ static int MSVCRT_vswscanf_l(const MSVCRT_wchar_t *file, const MSVCRT_wchar_t *format, MSVCRT__locale_t locale, __ms_va_list ap)
  98 #endif /* SECURE */
  99 #else /* WIDE_SCANF */
 100 #ifdef SECURE
 101 #define _FUNCTION_ static int MSVCRT_vsscanf_s_l(const char *file, const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
 102 #else  /* SECURE */
 103 #define _FUNCTION_ static int MSVCRT_vsscanf_l(const char *file, const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
 104 #endif /* SECURE */
 105 #endif /* WIDE_SCANF */
 106 #endif /* STRING_LEN */
 107 #else /* STRING */
 108 #ifdef WIDE_SCANF
 109 #define _GETC_(file) (consumed++, MSVCRT_fgetwc(file))
 110 #define _UNGETC_(nch, file) do { MSVCRT_ungetwc(nch, file); consumed--; } while(0)
 111 #define _LOCK_FILE_(file) MSVCRT__lock_file(file)
 112 #define _UNLOCK_FILE_(file) MSVCRT__unlock_file(file)
 113 #ifdef SECURE
 114 #define _FUNCTION_ static int MSVCRT_vfwscanf_s_l(MSVCRT_FILE* file, const MSVCRT_wchar_t *format, MSVCRT__locale_t locale, __ms_va_list ap)
 115 #else  /* SECURE */
 116 #define _FUNCTION_ static int MSVCRT_vfwscanf_l(MSVCRT_FILE* file, const MSVCRT_wchar_t *format, MSVCRT__locale_t locale, __ms_va_list ap)
 117 #endif /* SECURE */
 118 #else /* WIDE_SCANF */
 119 #define _GETC_(file) (consumed++, MSVCRT_fgetc(file))
 120 #define _UNGETC_(nch, file) do { MSVCRT_ungetc(nch, file); consumed--; } while(0)
 121 #define _LOCK_FILE_(file) MSVCRT__lock_file(file)
 122 #define _UNLOCK_FILE_(file) MSVCRT__unlock_file(file)
 123 #ifdef SECURE
 124 #define _FUNCTION_ static int MSVCRT_vfscanf_s_l(MSVCRT_FILE* file, const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
 125 #else  /* SECURE */
 126 #define _FUNCTION_ static int MSVCRT_vfscanf_l(MSVCRT_FILE* file, const char *format, MSVCRT__locale_t locale, __ms_va_list ap)
 127 #endif /* SECURE */
 128 #endif /* WIDE_SCANF */
 129 #endif /* STRING */
 130 #endif /* CONSOLE */
 131
 132 _FUNCTION_ {
 133     MSVCRT_pthreadlocinfo locinfo;
 134     int rd = 0, consumed = 0;
 135     int nch;
 136     if (!*format) return 0;
 137 #ifndef WIDE_SCANF
 138 #ifdef CONSOLE
 139     TRACE("(%s):\n", debugstr_a(format));
 140 #else /* CONSOLE */
 141 #ifdef STRING
 142     TRACE("%s (%s)\n", debugstr_a(file), debugstr_a(format));
 143 #else /* STRING */
 144     TRACE("%p (%s)\n", file, debugstr_a(format));
 145 #endif /* STRING */
 146 #endif /* CONSOLE */
 147 #endif /* WIDE_SCANF */
 148     _LOCK_FILE_(file);
 149
 150     nch = _GETC_(file);
 151     if (nch == _EOF_) {
 152         _UNLOCK_FILE_(file);
 153         return _EOF_RET;
 154     }
 155
 156     if(!locale)
 157         locinfo = get_locinfo();
 158     else
 159         locinfo = locale->locinfo;
 160
 161     while (*format) {
 162         /* a whitespace character in the format string causes scanf to read,
 163          * but not store, all consecutive white-space characters in the input
 164          * up to the next non-white-space character.  One white space character
 165          * in the input matches any number (including zero) and combination of
 166          * white-space characters in the input. */
 167         if (_ISSPACE_(*format)) {
 168             /* skip whitespace */
 169             while ((nch!=_EOF_) && _ISSPACE_(nch))
 170                 nch = _GETC_(file);
 171         }
 172         /* a format specification causes scanf to read and convert characters
 173          * in the input into values of a specified type.  The value is assigned
 174          * to an argument in the argument list.  Format specifications have
 175          * the form %[*][width][{h | l | I64 | L}]type */
 176         else if (*format == '%') {
 177             int st = 0; int suppress = 0; int width = 0;
 178             int base;
 179             int h_prefix = 0;
 180             int l_prefix = 0;
 181             int L_prefix = 0;
 182             int w_prefix = 0;
 183             int prefix_finished = 0;
 184             int I64_prefix = 0;
 185             format++;
 186             /* look for leading asterisk, which means 'suppress assignment of
 187              * this field'. */
 188             if (*format=='*') {
 189                 format++;
 190                 suppress=1;
 191             }
 192             /* look for width specification */
 193             while (_ISDIGIT_(*format)) {
 194                 width*=10;
 195                 width+=*format++ - '0';
 196             }
 197             if (width==0) width=-1; /* no width spec seen */
 198             /* read prefix (if any) */
 199             while (!prefix_finished) {
 200                 switch(*format) {
 201                 case 'h': h_prefix++; break;
 202                 case 'l':
 203                     if(*(format+1) == 'l') {
 204                         I64_prefix = 1;
 205                         format++;
 206                     }
 207                     l_prefix = 1;
 208                     break;
 209                 case 'w': w_prefix = 1; break;
 210                 case 'L': L_prefix = 1; break;
 211                 case 'I':
 212                     if (*(format + 1) == '6' &&
 213                         *(format + 2) == '4') {
 214                         I64_prefix = 1;
 215                         format += 2;
 216                     }
 217                     break;
 218                 default:
 219                     prefix_finished = 1;
 220                 }
 221                 if (!prefix_finished) format++;
 222             }
 223             /* read type */
 224             switch(*format) {
 225             case 'p':
 226             case 'P': /* pointer. */
 227                 if (sizeof(void *) == sizeof(LONGLONG)) I64_prefix = 1;
 228                 /* fall through */
 229             case 'x':
 230             case 'X': /* hexadecimal integer. */
 231                 base = 16;
 232                 goto number;
 233             case 'o': /* octal integer */
 234                 base = 8;
 235                 goto number;
 236             case 'u': /* unsigned decimal integer */
 237                 base = 10;
 238                 goto number;
 239             case 'd': /* signed decimal integer */
 240                 base = 10;
 241                 goto number;
 242             case 'i': /* generic integer */
 243                 base = 0;
 244             number: {
 245                     /* read an integer */
 246                     ULONGLONG cur = 0;
 247                     int negative = 0;
 248                     int seendigit=0;
 249                     /* skip initial whitespace */
 250                     while ((nch!=_EOF_) && _ISSPACE_(nch))
 251                         nch = _GETC_(file);
 252                     /* get sign */
 253                     if (nch == '-' || nch == '+') {
 254                         negative = (nch=='-');
 255                         nch = _GETC_(file);
 256                         if (width>0) width--;
 257                     }
 258                     /* look for leading indication of base */
 259                     if (width!=0 && nch == '0' && *format != 'p' && *format != 'P') {
 260                         nch = _GETC_(file);
 261                         if (width>0) width--;
 262                         seendigit=1;
 263                         if (width!=0 && (nch=='x' || nch=='X')) {
 264                             if (base==0)
 265                                 base=16;
 266                             if (base==16) {
 267                                 nch = _GETC_(file);
 268                                 if (width>0) width--;
 269                                 seendigit=0;
 270                             }
 271                         } else if (base==0)
 272                             base = 8;
 273                     }
 274                     /* format %i without indication of base */
 275                     if (base==0)
 276                         base = 10;
 277                     /* throw away leading zeros */
 278                     while (width!=0 && nch=='0') {
 279                         nch = _GETC_(file);
 280                         if (width>0) width--;
 281                         seendigit=1;
 282                     }
 283                     if (width!=0 && _CHAR2DIGIT_(nch, base)!=-1) {
 284                         cur = _CHAR2DIGIT_(nch, base);
 285                         nch = _GETC_(file);
 286                         if (width>0) width--;
 287                         seendigit=1;
 288                     }
 289                     /* read until no more digits */
 290                     while (width!=0 && (nch!=_EOF_) && _CHAR2DIGIT_(nch, base)!=-1) {
 291                         cur = cur*base + _CHAR2DIGIT_(nch, base);
 292                         nch = _GETC_(file);
 293                         if (width>0) width--;
 294                         seendigit=1;
 295                     }
 296                     /* okay, done! */
 297                     if (!seendigit) break; /* not a valid number */
 298                     st = 1;
 299                     if (!suppress) {
 300 #define _SET_NUMBER_(type) *va_arg(ap, type*) = negative ? -cur : cur
 301                         if (I64_prefix) _SET_NUMBER_(LONGLONG);
 302                         else if (l_prefix) _SET_NUMBER_(LONG);
 303                         else if (h_prefix == 1) _SET_NUMBER_(short int);
 304                         else _SET_NUMBER_(int);
 305                     }
 306                 }
 307                 break;
 308             case 'e':
 309             case 'E':
 310             case 'f':
 311             case 'g':
 312             case 'G': { /* read a float */
 313                     long double cur = 0;
 314                     int negative = 0;
 315                     /* skip initial whitespace */
 316                     while ((nch!=_EOF_) && _ISSPACE_(nch))
 317                         nch = _GETC_(file);
 318                     /* get sign. */
 319                     if (nch == '-' || nch == '+') {
 320                         negative = (nch=='-');
 321                         if (width>0) width--;
 322                         if (width==0) break;
 323                         nch = _GETC_(file);
 324                     }
 325                     /* get first digit. */
 326                     if (*locinfo->lconv->decimal_point != nch) {
 327                       if (!_ISDIGIT_(nch)) break;
 328                       cur = (nch - '0');
 329                       nch = _GETC_(file);
 330                       if (width>0) width--;
 331                       /* read until no more digits */
 332                       while (width!=0 && (nch!=_EOF_) && _ISDIGIT_(nch)) {
 333                         cur = cur*10 + (nch - '0');
 334                         nch = _GETC_(file);
 335                         if (width>0) width--;
 336                       }
 337                     } else {
 338                       cur = 0; /* Fix: .8 -> 0.8 */
 339                     }
 340                     /* handle decimals */
 341                     if (width!=0 && nch == *locinfo->lconv->decimal_point) {
 342                         long double dec = 1;
 343                         nch = _GETC_(file);
 344                         if (width>0) width--;
 345                         while (width!=0 && (nch!=_EOF_) && _ISDIGIT_(nch)) {
 346                             dec /= 10;
 347                             cur += dec * (nch - '0');
 348                             nch = _GETC_(file);
 349                             if (width>0) width--;
 350                         }
 351                     }
 352                     /* handle exponent */
 353                     if (width!=0 && (nch == 'e' || nch == 'E')) {
 354                         int exponent = 0, negexp = 0;
 355                         float expcnt;
 356                         nch = _GETC_(file);
 357                         if (width>0) width--;
 358                         /* possible sign on the exponent */
 359                         if (width!=0 && (nch=='+' || nch=='-')) {
 360                             negexp = (nch=='-');
 361                             nch = _GETC_(file);
 362                             if (width>0) width--;
 363                         }
 364                         /* exponent digits */
 365                         while (width!=0 && (nch!=_EOF_) && _ISDIGIT_(nch)) {
 366                             exponent *= 10;
 367                             exponent += (nch - '0');
 368                             nch = _GETC_(file);
 369                             if (width>0) width--;
 370                         }
 371                         /* update 'cur' with this exponent. */
 372                         expcnt =  negexp ? .1 : 10;
 373                         while (exponent!=0) {
 374                             if (exponent&1)
 375                                 cur*=expcnt;
 376                             exponent/=2;
 377                             expcnt=expcnt*expcnt;
 378                         }
 379                     }
 380                     st = 1;
 381                     if (!suppress) {
 382                         if (L_prefix) _SET_NUMBER_(long double);
 383                         else if (l_prefix) _SET_NUMBER_(double);
 384                         else _SET_NUMBER_(float);
 385                     }
 386                 }
 387                 break;
 388                 /* According to msdn,
 389                  * 's' reads a character string in a call to fscanf
 390                  * and 'S' a wide character string and vice versa in a
 391                  * call to fwscanf. The 'h', 'w' and 'l' prefixes override
 392                  * this behaviour. 'h' forces reading char * but 'l' and 'w'
 393                  * force reading WCHAR. */
 394             case 's':
 395                     if (w_prefix || l_prefix) goto widecharstring;
 396                     else if (h_prefix) goto charstring;
 397 #ifdef WIDE_SCANF
 398                     else goto widecharstring;
 399 #else /* WIDE_SCANF */
 400                     else goto charstring;
 401 #endif /* WIDE_SCANF */
 402             case 'S':
 403                     if (w_prefix || l_prefix) goto widecharstring;
 404                     else if (h_prefix) goto charstring;
 405 #ifdef WIDE_SCANF
 406                     else goto charstring;
 407 #else /* WIDE_SCANF */
 408                     else goto widecharstring;
 409 #endif /* WIDE_SCANF */
 410             charstring: { /* read a word into a char */
 411                     char *sptr = suppress ? NULL : va_arg(ap, char*);
 412                     char *sptr_beg = sptr;
 413 #ifdef SECURE
 414                     unsigned size = suppress ? UINT_MAX : va_arg(ap, unsigned);
 415 #else
 416                     unsigned size = UINT_MAX;
 417 #endif
 418                     /* skip initial whitespace */
 419                     while ((nch!=_EOF_) && _ISSPACE_(nch))
 420                         nch = _GETC_(file);
 421                     /* read until whitespace */
 422                     while (width!=0 && (nch!=_EOF_) && !_ISSPACE_(nch)) {
 423                         if (!suppress) {
 424                             *sptr++ = _CHAR2SUPPORTED_(nch);
 425                             if(size>1) size--;
 426                             else {
 427                                 _UNLOCK_FILE_(file);
 428                                 *sptr_beg = 0;
 429                                 return rd;
 430                             }
 431                         }
 432                         st++;
 433                         nch = _GETC_(file);
 434                         if (width>0) width--;
 435                     }
 436                     /* terminate */
 437                     if (!suppress) *sptr = 0;
 438                 }
 439                 break;
 440             widecharstring: { /* read a word into a wchar_t* */
 441                     MSVCRT_wchar_t *sptr = suppress ? NULL : va_arg(ap, MSVCRT_wchar_t*);
 442                     MSVCRT_wchar_t *sptr_beg = sptr;
 443 #ifdef SECURE
 444                     unsigned size = suppress ? UINT_MAX : va_arg(ap, unsigned);
 445 #else
 446                     unsigned size = UINT_MAX;
 447 #endif
 448                     /* skip initial whitespace */
 449                     while ((nch!=_EOF_) && _ISSPACE_(nch))
 450                         nch = _GETC_(file);
 451                     /* read until whitespace */
 452                     while (width!=0 && (nch!=_EOF_) && !_ISSPACE_(nch)) {
 453                         if (!suppress) {
 454                             *sptr++ = _WIDE2SUPPORTED_(nch);
 455                             if(size>1) size--;
 456                             else {
 457                                 _UNLOCK_FILE_(file);
 458                                 *sptr_beg = 0;
 459                                 return rd;
 460                             }
 461                         }
 462                         st++;
 463                         nch = _GETC_(file);
 464                         if (width>0) width--;
 465                     }
 466                     /* terminate */
 467                     if (!suppress) *sptr = 0;
 468                 }
 469                 break;
 470             /* 'c' and 'C work analogously to 's' and 'S' as described
 471              * above */
 472             case 'c':
 473                     if (w_prefix || l_prefix) goto widecharacter;
 474                     else if (h_prefix) goto character;
 475 #ifdef WIDE_SCANF
 476                     else goto widecharacter;
 477 #else /* WIDE_SCANF */
 478                     else goto character;
 479 #endif /* WIDE_SCANF */
 480             case 'C':
 481                     if (w_prefix || l_prefix) goto widecharacter;
 482                     else if (h_prefix) goto character;
 483 #ifdef WIDE_SCANF
 484                     else goto character;
 485 #else /* WIDE_SCANF */
 486                     else goto widecharacter;
 487 #endif /* WIDE_SCANF */
 488           character: { /* read single character into char */
 489                     char *str = suppress ? NULL : va_arg(ap, char*);
 490                     char *pstr = str;
 491 #ifdef SECURE
 492                     unsigned size = suppress ? UINT_MAX : va_arg(ap, unsigned)/sizeof(char);
 493 #else
 494                     unsigned size = UINT_MAX;
 495 #endif
 496                     if (width == -1) width = 1;
 497                     while (width && (nch != _EOF_))
 498                     {
 499                         if (!suppress) {
 500                             *str++ = _CHAR2SUPPORTED_(nch);
 501                             if(size) size--;
 502                             else {
 503                                 _UNLOCK_FILE_(file);
 504                                 *pstr = 0;
 505                                 return rd;
 506                             }
 507                         }
 508                         st++;
 509                         width--;
 510                         nch = _GETC_(file);
 511                     }
 512                 }
 513                 break;
 514           widecharacter: { /* read single character into a wchar_t */
 515                     MSVCRT_wchar_t *str = suppress ? NULL : va_arg(ap, MSVCRT_wchar_t*);
 516                     MSVCRT_wchar_t *pstr = str;
 517 #ifdef SECURE
 518                     unsigned size = suppress ? UINT_MAX : va_arg(ap, unsigned)/sizeof(MSVCRT_wchar_t);
 519 #else
 520                     unsigned size = UINT_MAX;
 521 #endif
 522                     if (width == -1) width = 1;
 523                     while (width && (nch != _EOF_))
 524                     {
 525                         if (!suppress) {
 526                             *str++ = _WIDE2SUPPORTED_(nch);
 527                             if(size) size--;
 528                             else {
 529                                 _UNLOCK_FILE_(file);
 530                                 *pstr = 0;
 531                                 return rd;
 532                             }
 533                         }
 534                         st++;
 535                         width--;
 536                         nch = _GETC_(file);
 537                     }
 538                 }
 539                 break;
 540             case 'n': {
 541                     if (!suppress) {
 542                         int*n = va_arg(ap, int*);
 543                         *n = consumed - 1;
 544                     }
 545                     /* This is an odd one: according to the standard,
 546                      * "Execution of a %n directive does not increment the
 547                      * assignment count returned at the completion of
 548                      * execution" even if it wasn't suppressed with the
 549                      * '*' flag.  The Corrigendum to the standard seems
 550                      * to contradict this (comment out the assignment to
 551                      * suppress below if you want to implement these
 552                      * alternate semantics) but the windows program I'm
 553                      * looking at expects the behavior I've coded here
 554                      * (which happens to be what glibc does as well).
 555                      */
 556                     suppress = 1;
 557                     st = 1;
 558                 }
 559                 break;
 560             case '[': {
 561                     _CHAR_ *str = suppress ? NULL : va_arg(ap, _CHAR_*);
 562                     _CHAR_ *sptr = str;
 563                     RTL_BITMAP bitMask;
 564                     ULONG *Mask;
 565                     int invert = 0; /* Set if we are NOT to find the chars */
 566 #ifdef SECURE
 567                     unsigned size = suppress ? UINT_MAX : va_arg(ap, unsigned)/sizeof(_CHAR_);
 568 #else
 569                     unsigned size = UINT_MAX;
 570 #endif
 571
 572                     /* Init our bitmap */
 573                     Mask = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, _BITMAPSIZE_/8);
 574                     RtlInitializeBitMap(&bitMask, Mask, _BITMAPSIZE_);
 575
 576                     /* Read the format */
 577                     format++;
 578                     if(*format == '^') {
 579                         invert = 1;
 580                         format++;
 581                     }
 582                     if(*format == ']') {
 583                         RtlSetBits(&bitMask, ']', 1);
 584                         format++;
 585                     }
 586                     while(*format && (*format != ']')) {
 587                         /* According to msdn:
 588                          * "Note that %[a-z] and %[z-a] are interpreted as equivalent to %[abcde...z]." */
 589                         if((*format == '-') && (*(format + 1) != ']')) {
 590                             if ((*(format - 1)) < *(format + 1))
 591                                 RtlSetBits(&bitMask, *(format - 1) +1 , *(format + 1) - *(format - 1));
 592                             else
 593                                 RtlSetBits(&bitMask, *(format + 1)    , *(format - 1) - *(format + 1));
 594                             format++;
 595                         } else
 596                             RtlSetBits(&bitMask, *format, 1);
 597                         format++;
 598                     }
 599                     /* read until char is not suitable */
 600                     while ((width != 0) && (nch != _EOF_)) {
 601                         if(!invert) {
 602                             if(RtlAreBitsSet(&bitMask, nch, 1)) {
 603                                 if (!suppress) *sptr++ = _CHAR2SUPPORTED_(nch);
 604                             } else
 605                                 break;
 606                         } else {
 607                             if(RtlAreBitsClear(&bitMask, nch, 1)) {
 608                                 if (!suppress) *sptr++ = _CHAR2SUPPORTED_(nch);
 609                             } else
 610                                 break;
 611                         }
 612                         st++;
 613                         nch = _GETC_(file);
 614                         if (width>0) width--;
 615                         if(size>1) size--;
 616                         else {
 617                             _UNLOCK_FILE_(file);
 618                             *str = 0;
 619                             return rd;
 620                         }
 621                     }
 622                     /* terminate */
 623                     if (!suppress) *sptr = 0;
 624                     HeapFree(GetProcessHeap(), 0, Mask);
 625                 }
 626                 break;
 627             default:
 628                 /* From spec: "if a percent sign is followed by a character
 629                  * that has no meaning as a format-control character, that
 630                  * character and the following characters are treated as
 631                  * an ordinary sequence of characters, that is, a sequence
 632                  * of characters that must match the input.  For example,
 633                  * to specify that a percent-sign character is to be input,
 634                  * use %%." */
 635                 while ((nch!=_EOF_) && _ISSPACE_(nch))
 636                     nch = _GETC_(file);
 637                 if (nch==*format) {
 638                     suppress = 1; /* whoops no field to be read */
 639                     st = 1; /* but we got what we expected */
 640                     nch = _GETC_(file);
 641                 }
 642                 break;
 643             }
 644             if (st && !suppress) rd++;
 645             else if (!st) break;
 646         }
 647         /* a non-white-space character causes scanf to read, but not store,
 648          * a matching non-white-space character. */
 649         else {
 650             /* check for character match */
 651             if (nch == *format) {
 652                 nch = _GETC_(file);
 653             } else break;
 654         }
 655         format++;
 656     }
 657     if (nch!=_EOF_) {
 658         _UNGETC_(nch, file);
 659     }
 660
 661     TRACE("returning %d\n", rd);
 662     _UNLOCK_FILE_(file);
 663     return rd;
 664 }
 665
 666 #undef _CHAR_
 667 #undef _EOF_
 668 #undef _EOF_RET
 669 #undef _ISSPACE_
 670 #undef _ISDIGIT_
 671 #undef _CHAR2SUPPORTED_
 672 #undef _WIDE2SUPPORTED_
 673 #undef _CHAR2DIGIT_
 674 #undef _GETC_
 675 #undef _UNGETC_
 676 #undef _LOCK_FILE_
 677 #undef _UNLOCK_FILE_
 678 #undef _FUNCTION_
 679 #undef _BITMAPSIZE_