2 * Variant formatting functions
4 * Copyright 2008 Damjan Jovanovic
5 * Copyright 2003 Jon Griffiths
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 * Since the formatting functions aren't properly documented, I used the
23 * Visual Basic documentation as a guide to implementing these functions. This
24 * means that some named or user-defined formats may work slightly differently.
25 * Please submit a test case if you find a difference.
35 #define NONAMELESSUNION
36 #define NONAMELESSSTRUCT
39 #include "wine/unicode.h"
42 #include "wine/debug.h"
44 WINE_DEFAULT_DEBUG_CHANNEL(variant);
46 /* Make sure internal conversions to strings use the '.','+'/'-' and ','
47 * format chars from the US locale. This enables us to parse the created
48 * strings to determine the number of decimal places, exponent, etc.
50 #define LCID_US MAKELCID(MAKELANGID(LANG_ENGLISH,SUBLANG_ENGLISH_US),SORT_DEFAULT)
52 static const WCHAR szPercent_d[] = { '%','d','\0' };
53 static const WCHAR szPercentZeroTwo_d[] = { '%','0','2','d','\0' };
54 static const WCHAR szPercentZeroStar_d[] = { '%','0','*','d','\0' };
57 #define dump_tokens(rgb) do { \
58 int i_; TRACE("Tokens->{\n"); \
59 for (i_ = 0; i_ < rgb[0]; i_++) \
60 TRACE("%s0x%02x", i_?",":"",rgb[i_]); \
65 /******************************************************************************
66 * Variant-Formats {OLEAUT32}
69 * When formatting a variant a variety of format strings may be used to generate
70 * different kinds of formatted output. A format string consists of either a named
71 * format, or a user-defined format.
73 * The following named formats are defined:
76 *| General Date Display Date, and time for non-integer values
77 *| Short Date Short date format as defined by locale settings
78 *| Medium Date Medium date format as defined by locale settings
79 *| Long Date Long date format as defined by locale settings
80 *| Short Time Short Time format as defined by locale settings
81 *| Medium Time Medium time format as defined by locale settings
82 *| Long Time Long time format as defined by locale settings
83 *| True/False Localised text of "True" or "False"
84 *| Yes/No Localised text of "Yes" or "No"
85 *| On/Off Localised text of "On" or "Off"
86 *| General Number No thousands separator. No decimal points for integers
87 *| Currency General currency format using localised characters
88 *| Fixed At least one whole and two fractional digits
89 *| Standard Same as 'Fixed', but including decimal separators
90 *| Percent Multiply by 100 and display a trailing '%' character
91 *| Scientific Display with exponent
93 * User-defined formats consist of a combination of tokens and literal
94 * characters. Literal characters are copied unmodified to the formatted
95 * output at the position they occupy in the format string. Any character
96 * that is not recognised as a token is treated as a literal. A literal can
97 * also be specified by preceding it with a backslash character
98 * (e.g. "\L\i\t\e\r\a\l") or enclosing it in double quotes.
100 * A user-defined format can have up to 4 sections, depending on the type of
101 * format. The following table lists sections and their meaning:
102 *| Format Type Sections Meaning
103 *| ----------- -------- -------
104 *| Number 1 Use the same format for all numbers
105 *| Number 2 Use format 1 for positive and 2 for negative numbers
106 *| Number 3 Use format 1 for positive, 2 for zero, and 3
107 *| for negative numbers.
108 *| Number 4 Use format 1 for positive, 2 for zero, 3 for
109 *| negative, and 4 for null numbers.
110 *| String 1 Use the same format for all strings
111 *| String 2 Use format 2 for null and empty strings, otherwise
113 *| Date 1 Use the same format for all dates
115 * The formatting tokens fall into several categories depending on the type
116 * of formatted output. For more information on each type, see
117 * VarFormat-Dates(), VarFormat-Strings() and VarFormat-Numbers().
120 * VarTokenizeFormatString(), VarFormatFromTokens(), VarFormat(),
121 * VarFormatDateTime(), VarFormatNumber(), VarFormatCurrency().
124 /******************************************************************************
125 * VarFormat-Strings {OLEAUT32}
128 * When formatting a variant as a string, it is first converted to a VT_BSTR.
129 * The user-format string defines which characters are copied into which
130 * positions in the output string. Literals may be inserted in the format
131 * string. When creating the formatted string, excess characters in the string
132 * (those not consumed by a token) are appended to the end of the output. If
133 * there are more tokens than characters in the string to format, spaces will
134 * be inserted at the start of the string if the '@' token was used.
136 * By default strings are converted to lowercase, or uppercase if the '>' token
137 * is encountered. This applies to the whole string: it is not possible to
138 * generate a mixed-case output string.
140 * In user-defined string formats, the following tokens are recognised:
143 *| '@' Copy a char from the source, or a space if no chars are left.
144 *| '&' Copy a char from the source, or write nothing if no chars are left.
145 *| '<' Output the whole string as lower-case (the default).
146 *| '>' Output the whole string as upper-case.
147 *| '!' MSDN indicates that this character should cause right-to-left
148 *| copying, however tests show that it is tokenised but not processed.
152 * Common format definitions
156 #define FMT_TYPE_UNKNOWN 0x0
157 #define FMT_TYPE_GENERAL 0x1
158 #define FMT_TYPE_NUMBER 0x2
159 #define FMT_TYPE_DATE 0x3
160 #define FMT_TYPE_STRING 0x4
162 #define FMT_TO_STRING 0x0 /* If header->size == this, act like VB's Str() fn */
164 typedef struct tagFMT_SHORT_HEADER
166 BYTE size; /* Size of tokenised block (including header), or FMT_TO_STRING */
167 BYTE type; /* Allowable types (FMT_TYPE_*) */
168 BYTE offset[1]; /* Offset of the first (and only) format section */
171 typedef struct tagFMT_HEADER
173 BYTE size; /* Total size of the whole tokenised block (including header) */
174 BYTE type; /* Allowable types (FMT_TYPE_*) */
175 BYTE starts[4]; /* Offset of each of the 4 format sections, or 0 if none */
178 #define FmtGetPositive(x) (x->starts[0])
179 #define FmtGetNegative(x) (x->starts[1] ? x->starts[1] : x->starts[0])
180 #define FmtGetZero(x) (x->starts[2] ? x->starts[2] : x->starts[0])
181 #define FmtGetNull(x) (x->starts[3] ? x->starts[3] : x->starts[0])
187 #define FMT_FLAG_LT 0x1 /* Has '<' (lower case) */
188 #define FMT_FLAG_GT 0x2 /* Has '>' (upper case) */
189 #define FMT_FLAG_RTL 0x4 /* Has '!' (Copy right to left) */
191 typedef struct tagFMT_STRING_HEADER
193 BYTE flags; /* LT, GT, RTL */
196 BYTE copy_chars; /* Number of chars to be copied */
204 #define FMT_FLAG_PERCENT 0x1 /* Has '%' (Percentage) */
205 #define FMT_FLAG_EXPONENT 0x2 /* Has 'e' (Exponent/Scientific notation) */
206 #define FMT_FLAG_THOUSANDS 0x4 /* Has ',' (Standard use of the thousands separator) */
207 #define FMT_FLAG_BOOL 0x20 /* Boolean format */
209 typedef struct tagFMT_NUMBER_HEADER
211 BYTE flags; /* PERCENT, EXPONENT, THOUSANDS, BOOL */
212 BYTE multiplier; /* Multiplier, 100 for percentages */
213 BYTE divisor; /* Divisor, 1000 if '%%' was used */
214 BYTE whole; /* Number of digits before the decimal point */
215 BYTE fractional; /* Number of digits after the decimal point */
221 typedef struct tagFMT_DATE_HEADER
231 * Format token values
233 #define FMT_GEN_COPY 0x00 /* \n, "lit" => 0,pos,len: Copy len chars from input+pos */
234 #define FMT_GEN_INLINE 0x01 /* => 1,len,[chars]: Copy len chars from token stream */
235 #define FMT_GEN_END 0x02 /* \0,; => 2: End of the tokenised format */
236 #define FMT_DATE_TIME_SEP 0x03 /* Time separator char */
237 #define FMT_DATE_DATE_SEP 0x04 /* Date separator char */
238 #define FMT_DATE_GENERAL 0x05 /* General format date */
239 #define FMT_DATE_QUARTER 0x06 /* Quarter of the year from 1-4 */
240 #define FMT_DATE_TIME_SYS 0x07 /* System long time format */
241 #define FMT_DATE_DAY 0x08 /* Day with no leading 0 */
242 #define FMT_DATE_DAY_0 0x09 /* Day with leading 0 */
243 #define FMT_DATE_DAY_SHORT 0x0A /* Short day name */
244 #define FMT_DATE_DAY_LONG 0x0B /* Long day name */
245 #define FMT_DATE_SHORT 0x0C /* Short date format */
246 #define FMT_DATE_LONG 0x0D /* Long date format */
247 #define FMT_DATE_MEDIUM 0x0E /* Medium date format */
248 #define FMT_DATE_DAY_WEEK 0x0F /* First day of the week */
249 #define FMT_DATE_WEEK_YEAR 0x10 /* First week of the year */
250 #define FMT_DATE_MON 0x11 /* Month with no leading 0 */
251 #define FMT_DATE_MON_0 0x12 /* Month with leading 0 */
252 #define FMT_DATE_MON_SHORT 0x13 /* Short month name */
253 #define FMT_DATE_MON_LONG 0x14 /* Long month name */
254 #define FMT_DATE_YEAR_DOY 0x15 /* Day of the year with no leading 0 */
255 #define FMT_DATE_YEAR_0 0x16 /* 2 digit year with leading 0 */
256 /* NOTE: token 0x17 is not defined, 'yyy' is not valid */
257 #define FMT_DATE_YEAR_LONG 0x18 /* 4 digit year */
258 #define FMT_DATE_MIN 0x1A /* Minutes with no leading 0 */
259 #define FMT_DATE_MIN_0 0x1B /* Minutes with leading 0 */
260 #define FMT_DATE_SEC 0x1C /* Seconds with no leading 0 */
261 #define FMT_DATE_SEC_0 0x1D /* Seconds with leading 0 */
262 #define FMT_DATE_HOUR 0x1E /* Hours with no leading 0 */
263 #define FMT_DATE_HOUR_0 0x1F /* Hours with leading 0 */
264 #define FMT_DATE_HOUR_12 0x20 /* Hours with no leading 0, 12 hour clock */
265 #define FMT_DATE_HOUR_12_0 0x21 /* Hours with leading 0, 12 hour clock */
266 #define FMT_DATE_TIME_UNK2 0x23
267 /* FIXME: probably missing some here */
268 #define FMT_DATE_AMPM_SYS1 0x2E /* AM/PM as defined by system settings */
269 #define FMT_DATE_AMPM_UPPER 0x2F /* Upper-case AM or PM */
270 #define FMT_DATE_A_UPPER 0x30 /* Upper-case A or P */
271 #define FMT_DATE_AMPM_SYS2 0x31 /* AM/PM as defined by system settings */
272 #define FMT_DATE_AMPM_LOWER 0x32 /* Lower-case AM or PM */
273 #define FMT_DATE_A_LOWER 0x33 /* Lower-case A or P */
274 #define FMT_NUM_COPY_ZERO 0x34 /* Copy 1 digit or 0 if no digit */
275 #define FMT_NUM_COPY_SKIP 0x35 /* Copy 1 digit or skip if no digit */
276 #define FMT_NUM_DECIMAL 0x36 /* Decimal separator */
277 #define FMT_NUM_EXP_POS_U 0x37 /* Scientific notation, uppercase, + sign */
278 #define FMT_NUM_EXP_NEG_U 0x38 /* Scientific notation, uppercase, - sign */
279 #define FMT_NUM_EXP_POS_L 0x39 /* Scientific notation, lowercase, + sign */
280 #define FMT_NUM_EXP_NEG_L 0x3A /* Scientific notation, lowercase, - sign */
281 #define FMT_NUM_CURRENCY 0x3B /* Currency symbol */
282 #define FMT_NUM_TRUE_FALSE 0x3D /* Convert to "True" or "False" */
283 #define FMT_NUM_YES_NO 0x3E /* Convert to "Yes" or "No" */
284 #define FMT_NUM_ON_OFF 0x3F /* Convert to "On" or "Off" */
285 #define FMT_STR_COPY_SPACE 0x40 /* Copy len chars with space if no char */
286 #define FMT_STR_COPY_SKIP 0x41 /* Copy len chars or skip if no char */
288 #define FMT_WINE_HOURS_12 0x81 /* Hours using 12 hour clock */
290 /* Named Formats and their tokenised values */
291 static const WCHAR szGeneralDate[] = { 'G','e','n','e','r','a','l',' ','D','a','t','e','\0' };
292 static const BYTE fmtGeneralDate[0x0a] =
294 0x0a,FMT_TYPE_DATE,sizeof(FMT_SHORT_HEADER),
296 FMT_DATE_GENERAL,FMT_GEN_END
299 static const WCHAR szShortDate[] = { 'S','h','o','r','t',' ','D','a','t','e','\0' };
300 static const BYTE fmtShortDate[0x0a] =
302 0x0a,FMT_TYPE_DATE,sizeof(FMT_SHORT_HEADER),
304 FMT_DATE_SHORT,FMT_GEN_END
307 static const WCHAR szMediumDate[] = { 'M','e','d','i','u','m',' ','D','a','t','e','\0' };
308 static const BYTE fmtMediumDate[0x0a] =
310 0x0a,FMT_TYPE_DATE,sizeof(FMT_SHORT_HEADER),
312 FMT_DATE_MEDIUM,FMT_GEN_END
315 static const WCHAR szLongDate[] = { 'L','o','n','g',' ','D','a','t','e','\0' };
316 static const BYTE fmtLongDate[0x0a] =
318 0x0a,FMT_TYPE_DATE,sizeof(FMT_SHORT_HEADER),
320 FMT_DATE_LONG,FMT_GEN_END
323 static const WCHAR szShortTime[] = { 'S','h','o','r','t',' ','T','i','m','e','\0' };
324 static const BYTE fmtShortTime[0x0c] =
326 0x0c,FMT_TYPE_DATE,sizeof(FMT_SHORT_HEADER),
328 FMT_DATE_TIME_UNK2,FMT_DATE_TIME_SEP,FMT_DATE_MIN_0,FMT_GEN_END
331 static const WCHAR szMediumTime[] = { 'M','e','d','i','u','m',' ','T','i','m','e','\0' };
332 static const BYTE fmtMediumTime[0x11] =
334 0x11,FMT_TYPE_DATE,sizeof(FMT_SHORT_HEADER),
336 FMT_DATE_HOUR_12_0,FMT_DATE_TIME_SEP,FMT_DATE_MIN_0,
337 FMT_GEN_INLINE,0x01,' ','\0',FMT_DATE_AMPM_SYS1,FMT_GEN_END
340 static const WCHAR szLongTime[] = { 'L','o','n','g',' ','T','i','m','e','\0' };
341 static const BYTE fmtLongTime[0x0d] =
343 0x0a,FMT_TYPE_DATE,sizeof(FMT_SHORT_HEADER),
345 FMT_DATE_TIME_SYS,FMT_GEN_END
348 static const WCHAR szTrueFalse[] = { 'T','r','u','e','/','F','a','l','s','e','\0' };
349 static const BYTE fmtTrueFalse[0x0d] =
351 0x0d,FMT_TYPE_NUMBER,sizeof(FMT_HEADER),0x0,0x0,0x0,
352 FMT_FLAG_BOOL,0x0,0x0,0x0,0x0,
353 FMT_NUM_TRUE_FALSE,FMT_GEN_END
356 static const WCHAR szYesNo[] = { 'Y','e','s','/','N','o','\0' };
357 static const BYTE fmtYesNo[0x0d] =
359 0x0d,FMT_TYPE_NUMBER,sizeof(FMT_HEADER),0x0,0x0,0x0,
360 FMT_FLAG_BOOL,0x0,0x0,0x0,0x0,
361 FMT_NUM_YES_NO,FMT_GEN_END
364 static const WCHAR szOnOff[] = { 'O','n','/','O','f','f','\0' };
365 static const BYTE fmtOnOff[0x0d] =
367 0x0d,FMT_TYPE_NUMBER,sizeof(FMT_HEADER),0x0,0x0,0x0,
368 FMT_FLAG_BOOL,0x0,0x0,0x0,0x0,
369 FMT_NUM_ON_OFF,FMT_GEN_END
372 static const WCHAR szGeneralNumber[] = { 'G','e','n','e','r','a','l',' ','N','u','m','b','e','r','\0' };
373 static const BYTE fmtGeneralNumber[sizeof(FMT_HEADER)] =
375 sizeof(FMT_HEADER),FMT_TYPE_GENERAL,sizeof(FMT_HEADER),0x0,0x0,0x0
378 static const WCHAR szCurrency[] = { 'C','u','r','r','e','n','c','y','\0' };
379 static const BYTE fmtCurrency[0x26] =
381 0x26,FMT_TYPE_NUMBER,sizeof(FMT_HEADER),0x12,0x0,0x0,
382 /* Positive numbers */
383 FMT_FLAG_THOUSANDS,0xcc,0x0,0x1,0x2,
384 FMT_NUM_CURRENCY,FMT_NUM_COPY_ZERO,0x1,FMT_NUM_DECIMAL,FMT_NUM_COPY_ZERO,0x2,
386 /* Negative numbers */
387 FMT_FLAG_THOUSANDS,0xcc,0x0,0x1,0x2,
388 FMT_GEN_INLINE,0x1,'(','\0',FMT_NUM_CURRENCY,FMT_NUM_COPY_ZERO,0x1,
389 FMT_NUM_DECIMAL,FMT_NUM_COPY_ZERO,0x2,FMT_GEN_INLINE,0x1,')','\0',
393 static const WCHAR szFixed[] = { 'F','i','x','e','d','\0' };
394 static const BYTE fmtFixed[0x11] =
396 0x11,FMT_TYPE_NUMBER,sizeof(FMT_HEADER),0x0,0x0,0x0,
398 FMT_NUM_COPY_ZERO,0x1,FMT_NUM_DECIMAL,FMT_NUM_COPY_ZERO,0x2,FMT_GEN_END
401 static const WCHAR szStandard[] = { 'S','t','a','n','d','a','r','d','\0' };
402 static const BYTE fmtStandard[0x11] =
404 0x11,FMT_TYPE_NUMBER,sizeof(FMT_HEADER),0x0,0x0,0x0,
405 FMT_FLAG_THOUSANDS,0x0,0x0,0x1,0x2,
406 FMT_NUM_COPY_ZERO,0x1,FMT_NUM_DECIMAL,FMT_NUM_COPY_ZERO,0x2,FMT_GEN_END
409 static const WCHAR szPercent[] = { 'P','e','r','c','e','n','t','\0' };
410 static const BYTE fmtPercent[0x15] =
412 0x15,FMT_TYPE_NUMBER,sizeof(FMT_HEADER),0x0,0x0,0x0,
413 FMT_FLAG_PERCENT,0x1,0x0,0x1,0x2,
414 FMT_NUM_COPY_ZERO,0x1,FMT_NUM_DECIMAL,FMT_NUM_COPY_ZERO,0x2,
415 FMT_GEN_INLINE,0x1,'%','\0',FMT_GEN_END
418 static const WCHAR szScientific[] = { 'S','c','i','e','n','t','i','f','i','c','\0' };
419 static const BYTE fmtScientific[0x13] =
421 0x13,FMT_TYPE_NUMBER,sizeof(FMT_HEADER),0x0,0x0,0x0,
422 FMT_FLAG_EXPONENT,0x0,0x0,0x1,0x2,
423 FMT_NUM_COPY_ZERO,0x1,FMT_NUM_DECIMAL,FMT_NUM_COPY_ZERO,0x2,FMT_NUM_EXP_POS_U,0x2,FMT_GEN_END
426 typedef struct tagNAMED_FORMAT
432 /* Format name to tokenised format. Must be kept sorted by name */
433 static const NAMED_FORMAT VARIANT_NamedFormats[] =
435 { szCurrency, fmtCurrency },
436 { szFixed, fmtFixed },
437 { szGeneralDate, fmtGeneralDate },
438 { szGeneralNumber, fmtGeneralNumber },
439 { szLongDate, fmtLongDate },
440 { szLongTime, fmtLongTime },
441 { szMediumDate, fmtMediumDate },
442 { szMediumTime, fmtMediumTime },
443 { szOnOff, fmtOnOff },
444 { szPercent, fmtPercent },
445 { szScientific, fmtScientific },
446 { szShortDate, fmtShortDate },
447 { szShortTime, fmtShortTime },
448 { szStandard, fmtStandard },
449 { szTrueFalse, fmtTrueFalse },
450 { szYesNo, fmtYesNo }
452 typedef const NAMED_FORMAT *LPCNAMED_FORMAT;
454 static int FormatCompareFn(const void *l, const void *r)
456 return strcmpiW(((LPCNAMED_FORMAT)l)->name, ((LPCNAMED_FORMAT)r)->name);
459 static inline const BYTE *VARIANT_GetNamedFormat(LPCWSTR lpszFormat)
464 key.name = lpszFormat;
465 fmt = bsearch(&key, VARIANT_NamedFormats,
466 sizeof(VARIANT_NamedFormats)/sizeof(NAMED_FORMAT),
467 sizeof(NAMED_FORMAT), FormatCompareFn);
468 return fmt ? fmt->format : NULL;
471 /* Return an error if the token for the value will not fit in the destination */
472 #define NEED_SPACE(x) if (cbTok < (int)(x)) return TYPE_E_BUFFERTOOSMALL; cbTok -= (x)
474 /* Non-zero if the format is unknown or a given type */
475 #define COULD_BE(typ) ((!fmt_number && header->type==FMT_TYPE_UNKNOWN)||header->type==typ)
477 /* State during tokenising */
478 #define FMT_STATE_OPEN_COPY 0x1 /* Last token written was a copy */
479 #define FMT_STATE_WROTE_DECIMAL 0x2 /* Already wrote a decimal separator */
480 #define FMT_STATE_SEEN_HOURS 0x4 /* See the hh specifier */
481 #define FMT_STATE_WROTE_MINUTES 0x8 /* Wrote minutes */
483 /**********************************************************************
484 * VarTokenizeFormatString [OLEAUT32.140]
486 * Convert a format string into tokenised form.
489 * lpszFormat [I] Format string to tokenise
490 * rgbTok [O] Destination for tokenised format
491 * cbTok [I] Size of rgbTok in bytes
492 * nFirstDay [I] First day of the week (1-7, or 0 for current system default)
493 * nFirstWeek [I] How to treat the first week (see notes)
494 * lcid [I] Locale Id of the format string
495 * pcbActual [O] If non-NULL, filled with the first token generated
498 * Success: S_OK. rgbTok contains the tokenised format.
499 * Failure: E_INVALIDARG, if any argument is invalid.
500 * TYPE_E_BUFFERTOOSMALL, if rgbTok is not large enough.
503 * Valid values for the nFirstWeek parameter are:
506 *| 0 Use the current system default
507 *| 1 The first week is that containing Jan 1
508 *| 2 Four or more days of the first week are in the current year
509 *| 3 The first week is 7 days long
510 * See Variant-Formats(), VarFormatFromTokens().
512 HRESULT WINAPI VarTokenizeFormatString(LPOLESTR lpszFormat, LPBYTE rgbTok,
513 int cbTok, int nFirstDay, int nFirstWeek,
514 LCID lcid, int *pcbActual)
516 /* Note: none of these strings should be NUL terminated */
517 static const WCHAR szTTTTT[] = { 't','t','t','t','t' };
518 static const WCHAR szAMPM[] = { 'A','M','P','M' };
519 static const WCHAR szampm[] = { 'a','m','p','m' };
520 static const WCHAR szAMSlashPM[] = { 'A','M','/','P','M' };
521 static const WCHAR szamSlashpm[] = { 'a','m','/','p','m' };
522 const BYTE *namedFmt;
523 FMT_HEADER *header = (FMT_HEADER*)rgbTok;
524 FMT_STRING_HEADER *str_header = (FMT_STRING_HEADER*)(rgbTok + sizeof(FMT_HEADER));
525 FMT_NUMBER_HEADER *num_header = (FMT_NUMBER_HEADER*)str_header;
526 BYTE* pOut = rgbTok + sizeof(FMT_HEADER) + sizeof(FMT_STRING_HEADER);
527 BYTE* pLastHours = NULL;
530 LPCWSTR pFormat = lpszFormat;
532 TRACE("(%s,%p,%d,%d,%d,0x%08x,%p)\n", debugstr_w(lpszFormat), rgbTok, cbTok,
533 nFirstDay, nFirstWeek, lcid, pcbActual);
536 nFirstDay < 0 || nFirstDay > 7 || nFirstWeek < 0 || nFirstWeek > 3)
539 if (!lpszFormat || !*lpszFormat)
541 /* An empty string means 'general format' */
542 NEED_SPACE(sizeof(BYTE));
543 *rgbTok = FMT_TO_STRING;
545 *pcbActual = FMT_TO_STRING;
550 cbTok = 255; /* Ensure we error instead of wrapping */
553 namedFmt = VARIANT_GetNamedFormat(lpszFormat);
556 NEED_SPACE(namedFmt[0]);
557 memcpy(rgbTok, namedFmt, namedFmt[0]);
558 TRACE("Using pre-tokenised named format %s\n", debugstr_w(lpszFormat));
559 /* FIXME: pcbActual */
564 NEED_SPACE(sizeof(FMT_HEADER) + sizeof(FMT_STRING_HEADER));
565 memset(header, 0, sizeof(FMT_HEADER));
566 memset(str_header, 0, sizeof(FMT_STRING_HEADER));
568 header->starts[fmt_number] = sizeof(FMT_HEADER);
578 while (*pFormat == ';')
581 if (++fmt_number > 3)
582 return E_INVALIDARG; /* too many formats */
587 TRACE("New header\n");
588 NEED_SPACE(sizeof(BYTE) + sizeof(FMT_STRING_HEADER));
589 *pOut++ = FMT_GEN_END;
591 header->starts[fmt_number] = pOut - rgbTok;
592 str_header = (FMT_STRING_HEADER*)pOut;
593 num_header = (FMT_NUMBER_HEADER*)pOut;
594 memset(str_header, 0, sizeof(FMT_STRING_HEADER));
595 pOut += sizeof(FMT_STRING_HEADER);
600 else if (*pFormat == '\\')
602 /* Escaped character */
605 NEED_SPACE(3 * sizeof(BYTE));
607 *pOut++ = FMT_GEN_COPY;
608 *pOut++ = pFormat - lpszFormat;
610 fmt_state |= FMT_STATE_OPEN_COPY;
614 fmt_state &= ~FMT_STATE_OPEN_COPY;
617 else if (*pFormat == '"')
620 * Note: Native encodes "" as a copy of length zero. That's just dumb, so
621 * here we avoid encoding anything in this case.
625 else if (pFormat[1] == '"')
631 LPCWSTR start = ++pFormat;
632 while (*pFormat && *pFormat != '"')
634 NEED_SPACE(3 * sizeof(BYTE));
635 *pOut++ = FMT_GEN_COPY;
636 *pOut++ = start - lpszFormat;
637 *pOut++ = pFormat - start;
640 TRACE("Quoted string pos %d, len %d\n", pOut[-2], pOut[-1]);
642 fmt_state &= ~FMT_STATE_OPEN_COPY;
648 else if (*pFormat == '0' && COULD_BE(FMT_TYPE_NUMBER))
650 /* Number formats: Digit from number or '0' if no digits
651 * Other formats: Literal
652 * Types the format if found
654 header->type = FMT_TYPE_NUMBER;
655 NEED_SPACE(2 * sizeof(BYTE));
656 *pOut++ = FMT_NUM_COPY_ZERO;
658 while (*pFormat == '0')
663 if (fmt_state & FMT_STATE_WROTE_DECIMAL)
664 num_header->fractional += *pOut;
666 num_header->whole += *pOut;
667 TRACE("%d 0's\n", *pOut);
669 fmt_state &= ~FMT_STATE_OPEN_COPY;
671 else if (*pFormat == '#' && COULD_BE(FMT_TYPE_NUMBER))
673 /* Number formats: Digit from number or blank if no digits
674 * Other formats: Literal
675 * Types the format if found
677 header->type = FMT_TYPE_NUMBER;
678 NEED_SPACE(2 * sizeof(BYTE));
679 *pOut++ = FMT_NUM_COPY_SKIP;
681 while (*pFormat == '#')
686 if (fmt_state & FMT_STATE_WROTE_DECIMAL)
687 num_header->fractional += *pOut;
689 num_header->whole += *pOut;
690 TRACE("%d #'s\n", *pOut);
692 fmt_state &= ~FMT_STATE_OPEN_COPY;
694 else if (*pFormat == '.' && COULD_BE(FMT_TYPE_NUMBER) &&
695 !(fmt_state & FMT_STATE_WROTE_DECIMAL))
697 /* Number formats: Decimal separator when 1st seen, literal thereafter
698 * Other formats: Literal
699 * Types the format if found
701 header->type = FMT_TYPE_NUMBER;
702 NEED_SPACE(sizeof(BYTE));
703 *pOut++ = FMT_NUM_DECIMAL;
704 fmt_state |= FMT_STATE_WROTE_DECIMAL;
705 fmt_state &= ~FMT_STATE_OPEN_COPY;
707 TRACE("decimal sep\n");
709 else if ((*pFormat == 'e' || *pFormat == 'E') && (pFormat[1] == '-' ||
710 pFormat[1] == '+') && header->type == FMT_TYPE_NUMBER)
712 /* Number formats: Exponent specifier
713 * Other formats: Literal
715 num_header->flags |= FMT_FLAG_EXPONENT;
716 NEED_SPACE(2 * sizeof(BYTE));
717 if (*pFormat == 'e') {
718 if (pFormat[1] == '+')
719 *pOut = FMT_NUM_EXP_POS_L;
721 *pOut = FMT_NUM_EXP_NEG_L;
723 if (pFormat[1] == '+')
724 *pOut = FMT_NUM_EXP_POS_U;
726 *pOut = FMT_NUM_EXP_NEG_U;
730 while (*pFormat == '0')
738 /* FIXME: %% => Divide by 1000 */
739 else if (*pFormat == ',' && header->type == FMT_TYPE_NUMBER)
741 /* Number formats: Use the thousands separator
742 * Other formats: Literal
744 num_header->flags |= FMT_FLAG_THOUSANDS;
746 fmt_state &= ~FMT_STATE_OPEN_COPY;
747 TRACE("thousands sep\n");
753 else if (*pFormat == '/' && COULD_BE(FMT_TYPE_DATE))
755 /* Date formats: Date separator
756 * Other formats: Literal
757 * Types the format if found
759 header->type = FMT_TYPE_DATE;
760 NEED_SPACE(sizeof(BYTE));
761 *pOut++ = FMT_DATE_DATE_SEP;
763 fmt_state &= ~FMT_STATE_OPEN_COPY;
766 else if (*pFormat == ':' && COULD_BE(FMT_TYPE_DATE))
768 /* Date formats: Time separator
769 * Other formats: Literal
770 * Types the format if found
772 header->type = FMT_TYPE_DATE;
773 NEED_SPACE(sizeof(BYTE));
774 *pOut++ = FMT_DATE_TIME_SEP;
776 fmt_state &= ~FMT_STATE_OPEN_COPY;
779 else if ((*pFormat == 'a' || *pFormat == 'A') &&
780 !strncmpiW(pFormat, szAMPM, sizeof(szAMPM)/sizeof(WCHAR)))
782 /* Date formats: System AM/PM designation
783 * Other formats: Literal
784 * Types the format if found
786 header->type = FMT_TYPE_DATE;
787 NEED_SPACE(sizeof(BYTE));
788 pFormat += sizeof(szAMPM)/sizeof(WCHAR);
789 if (!strncmpW(pFormat, szampm, sizeof(szampm)/sizeof(WCHAR)))
790 *pOut++ = FMT_DATE_AMPM_SYS2;
792 *pOut++ = FMT_DATE_AMPM_SYS1;
794 *pLastHours = *pLastHours + 2;
797 else if (*pFormat == 'a' && pFormat[1] == '/' &&
798 (pFormat[2] == 'p' || pFormat[2] == 'P'))
800 /* Date formats: lowercase a or p designation
801 * Other formats: Literal
802 * Types the format if found
804 header->type = FMT_TYPE_DATE;
805 NEED_SPACE(sizeof(BYTE));
807 *pOut++ = FMT_DATE_A_LOWER;
809 *pLastHours = *pLastHours + 2;
812 else if (*pFormat == 'A' && pFormat[1] == '/' &&
813 (pFormat[2] == 'p' || pFormat[2] == 'P'))
815 /* Date formats: Uppercase a or p designation
816 * Other formats: Literal
817 * Types the format if found
819 header->type = FMT_TYPE_DATE;
820 NEED_SPACE(sizeof(BYTE));
822 *pOut++ = FMT_DATE_A_UPPER;
824 *pLastHours = *pLastHours + 2;
827 else if (*pFormat == 'a' &&
828 !strncmpW(pFormat, szamSlashpm, sizeof(szamSlashpm)/sizeof(WCHAR)))
830 /* Date formats: lowercase AM or PM designation
831 * Other formats: Literal
832 * Types the format if found
834 header->type = FMT_TYPE_DATE;
835 NEED_SPACE(sizeof(BYTE));
836 pFormat += sizeof(szamSlashpm)/sizeof(WCHAR);
837 *pOut++ = FMT_DATE_AMPM_LOWER;
839 *pLastHours = *pLastHours + 2;
842 else if (*pFormat == 'A' &&
843 !strncmpW(pFormat, szAMSlashPM, sizeof(szAMSlashPM)/sizeof(WCHAR)))
845 /* Date formats: Uppercase AM or PM designation
846 * Other formats: Literal
847 * Types the format if found
849 header->type = FMT_TYPE_DATE;
850 NEED_SPACE(sizeof(BYTE));
851 pFormat += sizeof(szAMSlashPM)/sizeof(WCHAR);
852 *pOut++ = FMT_DATE_AMPM_UPPER;
855 else if ((*pFormat == 'c' || *pFormat == 'C') && COULD_BE(FMT_TYPE_DATE))
857 /* Date formats: General date format
858 * Other formats: Literal
859 * Types the format if found
861 header->type = FMT_TYPE_DATE;
862 NEED_SPACE(sizeof(BYTE));
863 pFormat += sizeof(szAMSlashPM)/sizeof(WCHAR);
864 *pOut++ = FMT_DATE_GENERAL;
867 else if ((*pFormat == 'd' || *pFormat == 'D') && COULD_BE(FMT_TYPE_DATE))
869 /* Date formats: Day specifier
870 * Other formats: Literal
871 * Types the format if found
874 header->type = FMT_TYPE_DATE;
875 while ((*pFormat == 'd' || *pFormat == 'D') && count < 6)
880 NEED_SPACE(sizeof(BYTE));
881 *pOut++ = FMT_DATE_DAY + count;
882 fmt_state &= ~FMT_STATE_OPEN_COPY;
883 /* When we find the days token, reset the seen hours state so that
884 * 'mm' is again written as month when encountered.
886 fmt_state &= ~FMT_STATE_SEEN_HOURS;
887 TRACE("%d d's\n", count + 1);
889 else if ((*pFormat == 'h' || *pFormat == 'H') && COULD_BE(FMT_TYPE_DATE))
891 /* Date formats: Hour specifier
892 * Other formats: Literal
893 * Types the format if found
895 header->type = FMT_TYPE_DATE;
896 NEED_SPACE(sizeof(BYTE));
898 /* Record the position of the hours specifier - if we encounter
899 * an am/pm specifier we will change the hours from 24 to 12.
902 if (*pFormat == 'h' || *pFormat == 'H')
905 *pOut++ = FMT_DATE_HOUR_0;
910 *pOut++ = FMT_DATE_HOUR;
913 fmt_state &= ~FMT_STATE_OPEN_COPY;
914 /* Note that now we have seen an hours token, the next occurrence of
915 * 'mm' indicates minutes, not months.
917 fmt_state |= FMT_STATE_SEEN_HOURS;
919 else if ((*pFormat == 'm' || *pFormat == 'M') && COULD_BE(FMT_TYPE_DATE))
921 /* Date formats: Month specifier (or Minute specifier, after hour specifier)
922 * Other formats: Literal
923 * Types the format if found
926 header->type = FMT_TYPE_DATE;
927 while ((*pFormat == 'm' || *pFormat == 'M') && count < 4)
932 NEED_SPACE(sizeof(BYTE));
933 if (count <= 1 && fmt_state & FMT_STATE_SEEN_HOURS &&
934 !(fmt_state & FMT_STATE_WROTE_MINUTES))
936 /* We have seen an hours specifier and not yet written a minutes
937 * specifier. Write this as minutes and thereafter as months.
939 *pOut++ = count == 1 ? FMT_DATE_MIN_0 : FMT_DATE_MIN;
940 fmt_state |= FMT_STATE_WROTE_MINUTES; /* Hereafter write months */
943 *pOut++ = FMT_DATE_MON + count; /* Months */
944 fmt_state &= ~FMT_STATE_OPEN_COPY;
945 TRACE("%d m's\n", count + 1);
947 else if ((*pFormat == 'n' || *pFormat == 'N') && COULD_BE(FMT_TYPE_DATE))
949 /* Date formats: Minute specifier
950 * Other formats: Literal
951 * Types the format if found
953 header->type = FMT_TYPE_DATE;
954 NEED_SPACE(sizeof(BYTE));
956 if (*pFormat == 'n' || *pFormat == 'N')
959 *pOut++ = FMT_DATE_MIN_0;
964 *pOut++ = FMT_DATE_MIN;
967 fmt_state &= ~FMT_STATE_OPEN_COPY;
969 else if ((*pFormat == 'q' || *pFormat == 'Q') && COULD_BE(FMT_TYPE_DATE))
971 /* Date formats: Quarter specifier
972 * Other formats: Literal
973 * Types the format if found
975 header->type = FMT_TYPE_DATE;
976 NEED_SPACE(sizeof(BYTE));
977 *pOut++ = FMT_DATE_QUARTER;
979 fmt_state &= ~FMT_STATE_OPEN_COPY;
982 else if ((*pFormat == 's' || *pFormat == 'S') && COULD_BE(FMT_TYPE_DATE))
984 /* Date formats: Second specifier
985 * Other formats: Literal
986 * Types the format if found
988 header->type = FMT_TYPE_DATE;
989 NEED_SPACE(sizeof(BYTE));
991 if (*pFormat == 's' || *pFormat == 'S')
994 *pOut++ = FMT_DATE_SEC_0;
999 *pOut++ = FMT_DATE_SEC;
1002 fmt_state &= ~FMT_STATE_OPEN_COPY;
1004 else if ((*pFormat == 't' || *pFormat == 'T') &&
1005 !strncmpiW(pFormat, szTTTTT, sizeof(szTTTTT)/sizeof(WCHAR)))
1007 /* Date formats: System time specifier
1008 * Other formats: Literal
1009 * Types the format if found
1011 header->type = FMT_TYPE_DATE;
1012 pFormat += sizeof(szTTTTT)/sizeof(WCHAR);
1013 NEED_SPACE(sizeof(BYTE));
1014 *pOut++ = FMT_DATE_TIME_SYS;
1015 fmt_state &= ~FMT_STATE_OPEN_COPY;
1017 else if ((*pFormat == 'w' || *pFormat == 'W') && COULD_BE(FMT_TYPE_DATE))
1019 /* Date formats: Week of the year/Day of the week
1020 * Other formats: Literal
1021 * Types the format if found
1023 header->type = FMT_TYPE_DATE;
1025 if (*pFormat == 'w' || *pFormat == 'W')
1027 NEED_SPACE(3 * sizeof(BYTE));
1029 *pOut++ = FMT_DATE_WEEK_YEAR;
1030 *pOut++ = nFirstDay;
1031 *pOut++ = nFirstWeek;
1036 NEED_SPACE(2 * sizeof(BYTE));
1037 *pOut++ = FMT_DATE_DAY_WEEK;
1038 *pOut++ = nFirstDay;
1042 fmt_state &= ~FMT_STATE_OPEN_COPY;
1044 else if ((*pFormat == 'y' || *pFormat == 'Y') && COULD_BE(FMT_TYPE_DATE))
1046 /* Date formats: Day of year/Year specifier
1047 * Other formats: Literal
1048 * Types the format if found
1051 header->type = FMT_TYPE_DATE;
1052 while ((*pFormat == 'y' || *pFormat == 'Y') && count < 4)
1059 count--; /* 'yyy' has no meaning, despite what MSDN says */
1062 NEED_SPACE(sizeof(BYTE));
1063 *pOut++ = FMT_DATE_YEAR_DOY + count;
1064 fmt_state &= ~FMT_STATE_OPEN_COPY;
1065 TRACE("%d y's\n", count + 1);
1071 else if (*pFormat == '@' && COULD_BE(FMT_TYPE_STRING))
1073 /* String formats: Character from string or space if no char
1074 * Other formats: Literal
1075 * Types the format if found
1077 header->type = FMT_TYPE_STRING;
1078 NEED_SPACE(2 * sizeof(BYTE));
1079 *pOut++ = FMT_STR_COPY_SPACE;
1081 while (*pFormat == '@')
1084 str_header->copy_chars++;
1087 TRACE("%d @'s\n", *pOut);
1089 fmt_state &= ~FMT_STATE_OPEN_COPY;
1091 else if (*pFormat == '&' && COULD_BE(FMT_TYPE_STRING))
1093 /* String formats: Character from string or skip if no char
1094 * Other formats: Literal
1095 * Types the format if found
1097 header->type = FMT_TYPE_STRING;
1098 NEED_SPACE(2 * sizeof(BYTE));
1099 *pOut++ = FMT_STR_COPY_SKIP;
1101 while (*pFormat == '&')
1104 str_header->copy_chars++;
1107 TRACE("%d &'s\n", *pOut);
1109 fmt_state &= ~FMT_STATE_OPEN_COPY;
1111 else if ((*pFormat == '<' || *pFormat == '>') && COULD_BE(FMT_TYPE_STRING))
1113 /* String formats: Use upper/lower case
1114 * Other formats: Literal
1115 * Types the format if found
1117 header->type = FMT_TYPE_STRING;
1118 if (*pFormat == '<')
1119 str_header->flags |= FMT_FLAG_LT;
1121 str_header->flags |= FMT_FLAG_GT;
1122 TRACE("to %s case\n", *pFormat == '<' ? "lower" : "upper");
1124 fmt_state &= ~FMT_STATE_OPEN_COPY;
1126 else if (*pFormat == '!' && COULD_BE(FMT_TYPE_STRING))
1128 /* String formats: Copy right to left
1129 * Other formats: Literal
1130 * Types the format if found
1132 header->type = FMT_TYPE_STRING;
1133 str_header->flags |= FMT_FLAG_RTL;
1135 fmt_state &= ~FMT_STATE_OPEN_COPY;
1136 TRACE("copy right-to-left\n");
1142 /* FIXME: [ seems to be ignored */
1145 if (*pFormat == '%' && header->type == FMT_TYPE_NUMBER)
1147 /* Number formats: Percentage indicator, also a literal
1148 * Other formats: Literal
1149 * Doesn't type the format
1151 num_header->flags |= FMT_FLAG_PERCENT;
1154 if (fmt_state & FMT_STATE_OPEN_COPY)
1156 pOut[-1] = pOut[-1] + 1; /* Increase the length of the open copy */
1157 TRACE("extend copy (char '%c'), length now %d\n", *pFormat, pOut[-1]);
1161 /* Create a new open copy */
1162 TRACE("New copy (char '%c')\n", *pFormat);
1163 NEED_SPACE(3 * sizeof(BYTE));
1164 *pOut++ = FMT_GEN_COPY;
1165 *pOut++ = pFormat - lpszFormat;
1167 fmt_state |= FMT_STATE_OPEN_COPY;
1173 *pOut++ = FMT_GEN_END;
1175 header->size = pOut - rgbTok;
1177 *pcbActual = header->size;
1182 /* Number formatting state flags */
1183 #define NUM_WROTE_DEC 0x01 /* Written the decimal separator */
1184 #define NUM_WRITE_ON 0x02 /* Started to write the number */
1185 #define NUM_WROTE_SIGN 0x04 /* Written the negative sign */
1187 /* Format a variant using a number format */
1188 static HRESULT VARIANT_FormatNumber(LPVARIANT pVarIn, LPOLESTR lpszFormat,
1189 LPBYTE rgbTok, ULONG dwFlags,
1190 BSTR *pbstrOut, LCID lcid)
1192 BYTE rgbDig[256], *prgbDig;
1194 int have_int, need_int = 0, have_frac, need_frac, exponent = 0, pad = 0;
1195 WCHAR buff[256], *pBuff = buff;
1196 WCHAR thousandSeparator[32];
1197 VARIANT vString, vBool;
1199 FMT_HEADER *header = (FMT_HEADER*)rgbTok;
1200 FMT_NUMBER_HEADER *numHeader;
1201 const BYTE* pToken = NULL;
1202 HRESULT hRes = S_OK;
1204 TRACE("(%p->(%s%s),%s,%p,0x%08x,%p,0x%08x)\n", pVarIn, debugstr_VT(pVarIn),
1205 debugstr_VF(pVarIn), debugstr_w(lpszFormat), rgbTok, dwFlags, pbstrOut,
1208 V_VT(&vString) = VT_EMPTY;
1209 V_VT(&vBool) = VT_BOOL;
1211 if (V_TYPE(pVarIn) == VT_EMPTY || V_TYPE(pVarIn) == VT_NULL)
1213 have_int = have_frac = 0;
1214 numHeader = (FMT_NUMBER_HEADER*)(rgbTok + FmtGetNull(header));
1215 V_BOOL(&vBool) = VARIANT_FALSE;
1219 /* Get a number string from pVarIn, and parse it */
1220 hRes = VariantChangeTypeEx(&vString, pVarIn, LCID_US, VARIANT_NOUSEROVERRIDE, VT_BSTR);
1224 np.cDig = sizeof(rgbDig);
1225 np.dwInFlags = NUMPRS_STD;
1226 hRes = VarParseNumFromStr(V_BSTR(&vString), LCID_US, 0, &np, rgbDig);
1232 exponent = np.nPwr10;
1234 /* Figure out which format to use */
1235 if (np.dwOutFlags & NUMPRS_NEG)
1237 numHeader = (FMT_NUMBER_HEADER*)(rgbTok + FmtGetNegative(header));
1238 V_BOOL(&vBool) = VARIANT_TRUE;
1240 else if (have_int == 1 && !exponent && rgbDig[0] == 0)
1242 numHeader = (FMT_NUMBER_HEADER*)(rgbTok + FmtGetZero(header));
1243 V_BOOL(&vBool) = VARIANT_FALSE;
1247 numHeader = (FMT_NUMBER_HEADER*)(rgbTok + FmtGetPositive(header));
1248 V_BOOL(&vBool) = VARIANT_TRUE;
1251 TRACE("num header: flags = 0x%x, mult=%d, div=%d, whole=%d, fract=%d\n",
1252 numHeader->flags, numHeader->multiplier, numHeader->divisor,
1253 numHeader->whole, numHeader->fractional);
1255 need_int = numHeader->whole;
1256 need_frac = numHeader->fractional;
1258 if (numHeader->flags & FMT_FLAG_PERCENT &&
1259 !(have_int == 1 && !exponent && rgbDig[0] == 0))
1262 if (numHeader->flags & FMT_FLAG_EXPONENT)
1264 /* Exponent format: length of the integral number part is fixed and
1265 specified by the format. */
1266 pad = need_int - have_int;
1270 have_int = need_int;
1277 /* Convert the exponent */
1278 pad = max(exponent, -have_int);
1286 if(exponent < 0 && exponent > (-256 + have_int + have_frac))
1288 /* Remove exponent notation */
1289 memmove(rgbDig - exponent, rgbDig, have_int + have_frac);
1290 ZeroMemory(rgbDig, -exponent);
1291 have_frac -= exponent;
1296 /* Rounding the number */
1297 if (have_frac > need_frac)
1299 prgbDig = &rgbDig[have_int + need_frac];
1300 have_frac = need_frac;
1303 while (prgbDig-- > rgbDig && *prgbDig == 9)
1305 if (prgbDig < rgbDig)
1307 /* We reached the first digit and that was also a 9 */
1309 if (numHeader->flags & FMT_FLAG_EXPONENT)
1313 rgbDig[have_int + need_frac] = 0;
1323 /* We converted trailing digits to zeroes => have_frac has changed */
1324 while (have_frac > 0 && rgbDig[have_int + have_frac - 1] == 0)
1327 TRACE("have_int=%d,need_int=%d,have_frac=%d,need_frac=%d,pad=%d,exp=%d\n",
1328 have_int, need_int, have_frac, need_frac, pad, exponent);
1331 if (numHeader->flags & FMT_FLAG_THOUSANDS)
1333 if (!GetLocaleInfoW(lcid, LOCALE_STHOUSAND, thousandSeparator,
1334 sizeof(thousandSeparator)/sizeof(WCHAR)))
1336 thousandSeparator[0] = ',';
1337 thousandSeparator[1] = 0;
1341 pToken = (const BYTE*)numHeader + sizeof(FMT_NUMBER_HEADER);
1344 while (SUCCEEDED(hRes) && *pToken != FMT_GEN_END)
1346 WCHAR defaultChar = '?';
1347 DWORD boolFlag, localeValue = 0;
1348 BOOL shouldAdvance = TRUE;
1350 if (pToken - rgbTok > header->size)
1352 ERR("Ran off the end of the format!\n");
1353 hRes = E_INVALIDARG;
1354 goto VARIANT_FormatNumber_Exit;
1360 TRACE("copy %s\n", debugstr_wn(lpszFormat + pToken[1], pToken[2]));
1361 memcpy(pBuff, lpszFormat + pToken[1], pToken[2] * sizeof(WCHAR));
1366 case FMT_GEN_INLINE:
1368 TRACE("copy %s\n", debugstr_a((LPCSTR)pToken));
1370 *pBuff++ = *pToken++;
1373 case FMT_NUM_YES_NO:
1374 boolFlag = VAR_BOOLYESNO;
1375 goto VARIANT_FormatNumber_Bool;
1377 case FMT_NUM_ON_OFF:
1378 boolFlag = VAR_BOOLONOFF;
1379 goto VARIANT_FormatNumber_Bool;
1381 case FMT_NUM_TRUE_FALSE:
1382 boolFlag = VAR_LOCALBOOL;
1384 VARIANT_FormatNumber_Bool:
1386 BSTR boolStr = NULL;
1388 if (pToken[1] != FMT_GEN_END)
1390 ERR("Boolean token not at end of format!\n");
1391 hRes = E_INVALIDARG;
1392 goto VARIANT_FormatNumber_Exit;
1394 hRes = VarBstrFromBool(V_BOOL(&vBool), lcid, boolFlag, &boolStr);
1395 if (SUCCEEDED(hRes))
1397 strcpyW(pBuff, boolStr);
1398 SysFreeString(boolStr);
1405 case FMT_NUM_DECIMAL:
1406 if ((np.dwOutFlags & NUMPRS_NEG) && !(dwState & NUM_WROTE_SIGN) && !header->starts[1])
1408 /* last chance for a negative sign in the .# case */
1409 TRACE("write negative sign\n");
1410 localeValue = LOCALE_SNEGATIVESIGN;
1412 dwState |= NUM_WROTE_SIGN;
1413 shouldAdvance = FALSE;
1416 TRACE("write decimal separator\n");
1417 localeValue = LOCALE_SDECIMAL;
1419 dwState |= NUM_WROTE_DEC;
1422 case FMT_NUM_CURRENCY:
1423 TRACE("write currency symbol\n");
1424 localeValue = LOCALE_SCURRENCY;
1428 case FMT_NUM_EXP_POS_U:
1429 case FMT_NUM_EXP_POS_L:
1430 case FMT_NUM_EXP_NEG_U:
1431 case FMT_NUM_EXP_NEG_L:
1432 if (*pToken == FMT_NUM_EXP_POS_L || *pToken == FMT_NUM_EXP_NEG_L)
1439 sprintfW(pBuff, szPercentZeroStar_d, pToken[1], -exponent);
1443 if (*pToken == FMT_NUM_EXP_POS_L || *pToken == FMT_NUM_EXP_POS_U)
1445 sprintfW(pBuff, szPercentZeroStar_d, pToken[1], exponent);
1452 case FMT_NUM_COPY_ZERO:
1453 dwState |= NUM_WRITE_ON;
1456 case FMT_NUM_COPY_SKIP:
1457 TRACE("write %d %sdigits or %s\n", pToken[1],
1458 dwState & NUM_WROTE_DEC ? "fractional " : "",
1459 *pToken == FMT_NUM_COPY_ZERO ? "0" : "skip");
1461 if (dwState & NUM_WROTE_DEC)
1465 if (!(numHeader->flags & FMT_FLAG_EXPONENT) && exponent < 0)
1467 /* Pad with 0 before writing the fractional digits */
1468 pad = max(exponent, -pToken[1]);
1470 count = min(have_frac, pToken[1] + pad);
1471 for (i = 0; i > pad; i--)
1475 count = min(have_frac, pToken[1]);
1477 pad += pToken[1] - count;
1480 *pBuff++ = '0' + *prgbDig++;
1481 if (*pToken == FMT_NUM_COPY_ZERO)
1483 for (; pad > 0; pad--)
1484 *pBuff++ = '0'; /* Write zeros for missing trailing digits */
1489 int count, count_max, position;
1491 if ((np.dwOutFlags & NUMPRS_NEG) && !(dwState & NUM_WROTE_SIGN) && !header->starts[1])
1493 TRACE("write negative sign\n");
1494 localeValue = LOCALE_SNEGATIVESIGN;
1496 dwState |= NUM_WROTE_SIGN;
1497 shouldAdvance = FALSE;
1501 position = have_int + pad;
1502 if (dwState & NUM_WRITE_ON)
1503 position = max(position, need_int);
1504 need_int -= pToken[1];
1505 count_max = have_int + pad - need_int;
1508 if (dwState & NUM_WRITE_ON)
1510 count = pToken[1] - count_max;
1511 TRACE("write %d leading zeros\n", count);
1515 if ((numHeader->flags & FMT_FLAG_THOUSANDS) &&
1516 position > 1 && (--position % 3) == 0)
1519 TRACE("write thousand separator\n");
1520 for (k = 0; thousandSeparator[k]; k++)
1521 *pBuff++ = thousandSeparator[k];
1525 if (*pToken == FMT_NUM_COPY_ZERO || have_int > 1 ||
1526 (have_int > 0 && *prgbDig > 0))
1528 count = min(count_max, have_int);
1531 TRACE("write %d whole number digits\n", count);
1534 dwState |= NUM_WRITE_ON;
1535 *pBuff++ = '0' + *prgbDig++;
1536 if ((numHeader->flags & FMT_FLAG_THOUSANDS) &&
1537 position > 1 && (--position % 3) == 0)
1540 TRACE("write thousand separator\n");
1541 for (k = 0; thousandSeparator[k]; k++)
1542 *pBuff++ = thousandSeparator[k];
1546 count = min(count_max, pad);
1548 TRACE("write %d whole trailing 0's\n", count);
1552 if ((numHeader->flags & FMT_FLAG_THOUSANDS) &&
1553 position > 1 && (--position % 3) == 0)
1556 TRACE("write thousand separator\n");
1557 for (k = 0; thousandSeparator[k]; k++)
1558 *pBuff++ = thousandSeparator[k];
1566 ERR("Unknown token 0x%02x!\n", *pToken);
1567 hRes = E_INVALIDARG;
1568 goto VARIANT_FormatNumber_Exit;
1572 if (GetLocaleInfoW(lcid, localeValue, pBuff,
1573 sizeof(buff)/sizeof(WCHAR)-(pBuff-buff)))
1575 TRACE("added %s\n", debugstr_w(pBuff));
1581 TRACE("added %d '%c'\n", defaultChar, defaultChar);
1582 *pBuff++ = defaultChar;
1589 VARIANT_FormatNumber_Exit:
1590 VariantClear(&vString);
1592 TRACE("buff is %s\n", debugstr_w(buff));
1593 if (SUCCEEDED(hRes))
1595 *pbstrOut = SysAllocString(buff);
1597 hRes = E_OUTOFMEMORY;
1602 /* Format a variant using a date format */
1603 static HRESULT VARIANT_FormatDate(LPVARIANT pVarIn, LPOLESTR lpszFormat,
1604 LPBYTE rgbTok, ULONG dwFlags,
1605 BSTR *pbstrOut, LCID lcid)
1607 WCHAR buff[256], *pBuff = buff;
1610 FMT_HEADER *header = (FMT_HEADER*)rgbTok;
1611 FMT_DATE_HEADER *dateHeader;
1612 const BYTE* pToken = NULL;
1615 TRACE("(%p->(%s%s),%s,%p,0x%08x,%p,0x%08x)\n", pVarIn, debugstr_VT(pVarIn),
1616 debugstr_VF(pVarIn), debugstr_w(lpszFormat), rgbTok, dwFlags, pbstrOut,
1619 V_VT(&vDate) = VT_EMPTY;
1621 if (V_TYPE(pVarIn) == VT_EMPTY || V_TYPE(pVarIn) == VT_NULL)
1623 dateHeader = (FMT_DATE_HEADER*)(rgbTok + FmtGetNegative(header));
1628 USHORT usFlags = dwFlags & VARIANT_CALENDAR_HIJRI ? VAR_CALENDAR_HIJRI : 0;
1630 hRes = VariantChangeTypeEx(&vDate, pVarIn, LCID_US, usFlags, VT_DATE);
1633 dateHeader = (FMT_DATE_HEADER*)(rgbTok + FmtGetPositive(header));
1636 hRes = VarUdateFromDate(V_DATE(&vDate), 0 /* FIXME: flags? */, &udate);
1639 pToken = (const BYTE*)dateHeader + sizeof(FMT_DATE_HEADER);
1641 while (*pToken != FMT_GEN_END)
1643 DWORD dwVal = 0, localeValue = 0, dwFmt = 0;
1644 LPCWSTR szPrintFmt = NULL;
1645 WCHAR defaultChar = '?';
1647 if (pToken - rgbTok > header->size)
1649 ERR("Ran off the end of the format!\n");
1650 hRes = E_INVALIDARG;
1651 goto VARIANT_FormatDate_Exit;
1657 TRACE("copy %s\n", debugstr_wn(lpszFormat + pToken[1], pToken[2]));
1658 memcpy(pBuff, lpszFormat + pToken[1], pToken[2] * sizeof(WCHAR));
1663 case FMT_DATE_TIME_SEP:
1664 TRACE("time separator\n");
1665 localeValue = LOCALE_STIME;
1669 case FMT_DATE_DATE_SEP:
1670 TRACE("date separator\n");
1671 localeValue = LOCALE_SDATE;
1675 case FMT_DATE_GENERAL:
1679 hRes = VarBstrFromDate(V_DATE(&vDate), lcid, 0, &date);
1681 goto VARIANT_FormatDate_Exit;
1684 *pBuff++ = *pDate++;
1685 SysFreeString(date);
1689 case FMT_DATE_QUARTER:
1690 if (udate.st.wMonth <= 3)
1692 else if (udate.st.wMonth <= 6)
1694 else if (udate.st.wMonth <= 9)
1700 case FMT_DATE_TIME_SYS:
1702 /* FIXME: VARIANT_CALENDAR HIJRI should cause Hijri output */
1705 hRes = VarBstrFromDate(V_DATE(&vDate), lcid, VAR_TIMEVALUEONLY, &date);
1707 goto VARIANT_FormatDate_Exit;
1710 *pBuff++ = *pDate++;
1711 SysFreeString(date);
1716 szPrintFmt = szPercent_d;
1717 dwVal = udate.st.wDay;
1720 case FMT_DATE_DAY_0:
1721 szPrintFmt = szPercentZeroTwo_d;
1722 dwVal = udate.st.wDay;
1725 case FMT_DATE_DAY_SHORT:
1726 /* FIXME: VARIANT_CALENDAR HIJRI should cause Hijri output */
1727 TRACE("short day\n");
1728 localeValue = LOCALE_SABBREVDAYNAME1 + (udate.st.wDayOfWeek + 6)%7;
1732 case FMT_DATE_DAY_LONG:
1733 /* FIXME: VARIANT_CALENDAR HIJRI should cause Hijri output */
1734 TRACE("long day\n");
1735 localeValue = LOCALE_SDAYNAME1 + (udate.st.wDayOfWeek + 6)%7;
1739 case FMT_DATE_SHORT:
1740 /* FIXME: VARIANT_CALENDAR HIJRI should cause Hijri output */
1741 dwFmt = LOCALE_SSHORTDATE;
1745 /* FIXME: VARIANT_CALENDAR HIJRI should cause Hijri output */
1746 dwFmt = LOCALE_SLONGDATE;
1749 case FMT_DATE_MEDIUM:
1750 FIXME("Medium date treated as long date\n");
1751 dwFmt = LOCALE_SLONGDATE;
1754 case FMT_DATE_DAY_WEEK:
1755 szPrintFmt = szPercent_d;
1757 dwVal = udate.st.wDayOfWeek + 2 - pToken[1];
1760 GetLocaleInfoW(lcid,LOCALE_RETURN_NUMBER|LOCALE_IFIRSTDAYOFWEEK,
1761 (LPWSTR)&dwVal, sizeof(dwVal)/sizeof(WCHAR));
1762 dwVal = udate.st.wDayOfWeek + 1 - dwVal;
1767 case FMT_DATE_WEEK_YEAR:
1768 szPrintFmt = szPercent_d;
1769 dwVal = udate.wDayOfYear / 7 + 1;
1771 FIXME("Ignoring nFirstDay of %d, nFirstWeek of %d\n", pToken[0], pToken[1]);
1775 szPrintFmt = szPercent_d;
1776 dwVal = udate.st.wMonth;
1779 case FMT_DATE_MON_0:
1780 szPrintFmt = szPercentZeroTwo_d;
1781 dwVal = udate.st.wMonth;
1784 case FMT_DATE_MON_SHORT:
1785 /* FIXME: VARIANT_CALENDAR HIJRI should cause Hijri output */
1786 TRACE("short month\n");
1787 localeValue = LOCALE_SABBREVMONTHNAME1 + udate.st.wMonth - 1;
1791 case FMT_DATE_MON_LONG:
1792 /* FIXME: VARIANT_CALENDAR HIJRI should cause Hijri output */
1793 TRACE("long month\n");
1794 localeValue = LOCALE_SMONTHNAME1 + udate.st.wMonth - 1;
1798 case FMT_DATE_YEAR_DOY:
1799 szPrintFmt = szPercent_d;
1800 dwVal = udate.wDayOfYear;
1803 case FMT_DATE_YEAR_0:
1804 szPrintFmt = szPercentZeroTwo_d;
1805 dwVal = udate.st.wYear % 100;
1808 case FMT_DATE_YEAR_LONG:
1809 szPrintFmt = szPercent_d;
1810 dwVal = udate.st.wYear;
1814 szPrintFmt = szPercent_d;
1815 dwVal = udate.st.wMinute;
1818 case FMT_DATE_MIN_0:
1819 szPrintFmt = szPercentZeroTwo_d;
1820 dwVal = udate.st.wMinute;
1824 szPrintFmt = szPercent_d;
1825 dwVal = udate.st.wSecond;
1828 case FMT_DATE_SEC_0:
1829 szPrintFmt = szPercentZeroTwo_d;
1830 dwVal = udate.st.wSecond;
1834 szPrintFmt = szPercent_d;
1835 dwVal = udate.st.wHour;
1838 case FMT_DATE_HOUR_0:
1839 szPrintFmt = szPercentZeroTwo_d;
1840 dwVal = udate.st.wHour;
1843 case FMT_DATE_HOUR_12:
1844 szPrintFmt = szPercent_d;
1845 dwVal = udate.st.wHour ? udate.st.wHour > 12 ? udate.st.wHour - 12 : udate.st.wHour : 12;
1848 case FMT_DATE_HOUR_12_0:
1849 szPrintFmt = szPercentZeroTwo_d;
1850 dwVal = udate.st.wHour ? udate.st.wHour > 12 ? udate.st.wHour - 12 : udate.st.wHour : 12;
1853 case FMT_DATE_AMPM_SYS1:
1854 case FMT_DATE_AMPM_SYS2:
1855 localeValue = udate.st.wHour < 12 ? LOCALE_S1159 : LOCALE_S2359;
1859 case FMT_DATE_AMPM_UPPER:
1860 *pBuff++ = udate.st.wHour < 12 ? 'A' : 'P';
1864 case FMT_DATE_A_UPPER:
1865 *pBuff++ = udate.st.wHour < 12 ? 'A' : 'P';
1868 case FMT_DATE_AMPM_LOWER:
1869 *pBuff++ = udate.st.wHour < 12 ? 'a' : 'p';
1873 case FMT_DATE_A_LOWER:
1874 *pBuff++ = udate.st.wHour < 12 ? 'a' : 'p';
1878 ERR("Unknown token 0x%02x!\n", *pToken);
1879 hRes = E_INVALIDARG;
1880 goto VARIANT_FormatDate_Exit;
1885 if (GetLocaleInfoW(lcid, localeValue, pBuff,
1886 sizeof(buff)/sizeof(WCHAR)-(pBuff-buff)))
1888 TRACE("added %s\n", debugstr_w(pBuff));
1894 TRACE("added %d %c\n", defaultChar, defaultChar);
1895 *pBuff++ = defaultChar;
1902 if (!GetLocaleInfoW(lcid, dwFmt, fmt_buff, sizeof(fmt_buff)/sizeof(WCHAR)) ||
1903 !GetDateFormatW(lcid, 0, &udate.st, fmt_buff, pBuff,
1904 sizeof(buff)/sizeof(WCHAR)-(pBuff-buff)))
1906 hRes = E_INVALIDARG;
1907 goto VARIANT_FormatDate_Exit;
1912 else if (szPrintFmt)
1914 sprintfW(pBuff, szPrintFmt, dwVal);
1921 VARIANT_FormatDate_Exit:
1923 TRACE("buff is %s\n", debugstr_w(buff));
1924 if (SUCCEEDED(hRes))
1926 *pbstrOut = SysAllocString(buff);
1928 hRes = E_OUTOFMEMORY;
1933 /* Format a variant using a string format */
1934 static HRESULT VARIANT_FormatString(LPVARIANT pVarIn, LPOLESTR lpszFormat,
1935 LPBYTE rgbTok, ULONG dwFlags,
1936 BSTR *pbstrOut, LCID lcid)
1938 static WCHAR szEmpty[] = { '\0' };
1939 WCHAR buff[256], *pBuff = buff;
1941 FMT_HEADER *header = (FMT_HEADER*)rgbTok;
1942 FMT_STRING_HEADER *strHeader;
1943 const BYTE* pToken = NULL;
1946 BOOL bUpper = FALSE;
1947 HRESULT hRes = S_OK;
1949 TRACE("(%p->(%s%s),%s,%p,0x%08x,%p,0x%08x)\n", pVarIn, debugstr_VT(pVarIn),
1950 debugstr_VF(pVarIn), debugstr_w(lpszFormat), rgbTok, dwFlags, pbstrOut,
1953 V_VT(&vStr) = VT_EMPTY;
1955 if (V_TYPE(pVarIn) == VT_EMPTY || V_TYPE(pVarIn) == VT_NULL)
1957 strHeader = (FMT_STRING_HEADER*)(rgbTok + FmtGetNegative(header));
1958 V_BSTR(&vStr) = szEmpty;
1962 hRes = VariantChangeTypeEx(&vStr, pVarIn, LCID_US, VARIANT_NOUSEROVERRIDE, VT_BSTR);
1966 if (V_BSTR(&vStr)[0] == '\0')
1967 strHeader = (FMT_STRING_HEADER*)(rgbTok + FmtGetNegative(header));
1969 strHeader = (FMT_STRING_HEADER*)(rgbTok + FmtGetPositive(header));
1971 pSrc = V_BSTR(&vStr);
1972 if ((strHeader->flags & (FMT_FLAG_LT|FMT_FLAG_GT)) == FMT_FLAG_GT)
1974 blanks_first = strHeader->copy_chars - strlenW(pSrc);
1975 pToken = (const BYTE*)strHeader + sizeof(FMT_DATE_HEADER);
1977 while (*pToken != FMT_GEN_END)
1981 if (pToken - rgbTok > header->size)
1983 ERR("Ran off the end of the format!\n");
1984 hRes = E_INVALIDARG;
1985 goto VARIANT_FormatString_Exit;
1991 TRACE("copy %s\n", debugstr_wn(lpszFormat + pToken[1], pToken[2]));
1992 memcpy(pBuff, lpszFormat + pToken[1], pToken[2] * sizeof(WCHAR));
1997 case FMT_STR_COPY_SPACE:
1998 case FMT_STR_COPY_SKIP:
1999 dwCount = pToken[1];
2000 if (*pToken == FMT_STR_COPY_SPACE && blanks_first > 0)
2002 TRACE("insert %d initial spaces\n", blanks_first);
2003 while (dwCount > 0 && blanks_first > 0)
2010 TRACE("copy %d chars%s\n", dwCount,
2011 *pToken == FMT_STR_COPY_SPACE ? " with space" :"");
2012 while (dwCount > 0 && *pSrc)
2015 *pBuff++ = toupperW(*pSrc);
2017 *pBuff++ = tolowerW(*pSrc);
2021 if (*pToken == FMT_STR_COPY_SPACE && dwCount > 0)
2023 TRACE("insert %d spaces\n", dwCount);
2024 while (dwCount-- > 0)
2031 ERR("Unknown token 0x%02x!\n", *pToken);
2032 hRes = E_INVALIDARG;
2033 goto VARIANT_FormatString_Exit;
2038 VARIANT_FormatString_Exit:
2039 /* Copy out any remaining chars */
2043 *pBuff++ = toupperW(*pSrc);
2045 *pBuff++ = tolowerW(*pSrc);
2048 VariantClear(&vStr);
2050 TRACE("buff is %s\n", debugstr_w(buff));
2051 if (SUCCEEDED(hRes))
2053 *pbstrOut = SysAllocString(buff);
2055 hRes = E_OUTOFMEMORY;
2060 #define NUMBER_VTBITS (VTBIT_I1|VTBIT_UI1|VTBIT_I2|VTBIT_UI2| \
2061 VTBIT_I4|VTBIT_UI4|VTBIT_I8|VTBIT_UI8| \
2062 VTBIT_R4|VTBIT_R8|VTBIT_CY|VTBIT_DECIMAL| \
2063 VTBIT_BOOL|VTBIT_INT|VTBIT_UINT)
2065 /**********************************************************************
2066 * VarFormatFromTokens [OLEAUT32.139]
2068 HRESULT WINAPI VarFormatFromTokens(LPVARIANT pVarIn, LPOLESTR lpszFormat,
2069 LPBYTE rgbTok, ULONG dwFlags,
2070 BSTR *pbstrOut, LCID lcid)
2072 FMT_SHORT_HEADER *header = (FMT_SHORT_HEADER *)rgbTok;
2076 TRACE("(%p,%s,%p,%x,%p,0x%08x)\n", pVarIn, debugstr_w(lpszFormat),
2077 rgbTok, dwFlags, pbstrOut, lcid);
2080 return E_INVALIDARG;
2084 if (!pVarIn || !rgbTok)
2085 return E_INVALIDARG;
2087 if (V_VT(pVarIn) == VT_NULL)
2090 if (*rgbTok == FMT_TO_STRING || header->type == FMT_TYPE_GENERAL)
2092 /* According to MSDN, general format acts somewhat like the 'Str'
2093 * function in Visual Basic.
2095 VarFormatFromTokens_AsStr:
2096 V_VT(&vTmp) = VT_EMPTY;
2097 hres = VariantChangeTypeEx(&vTmp, pVarIn, lcid, dwFlags, VT_BSTR);
2098 *pbstrOut = V_BSTR(&vTmp);
2102 if (header->type == FMT_TYPE_NUMBER ||
2103 (header->type == FMT_TYPE_UNKNOWN && ((1 << V_TYPE(pVarIn)) & NUMBER_VTBITS)))
2105 hres = VARIANT_FormatNumber(pVarIn, lpszFormat, rgbTok, dwFlags, pbstrOut, lcid);
2107 else if (header->type == FMT_TYPE_DATE ||
2108 (header->type == FMT_TYPE_UNKNOWN && V_TYPE(pVarIn) == VT_DATE))
2110 hres = VARIANT_FormatDate(pVarIn, lpszFormat, rgbTok, dwFlags, pbstrOut, lcid);
2112 else if (header->type == FMT_TYPE_STRING || V_TYPE(pVarIn) == VT_BSTR)
2114 hres = VARIANT_FormatString(pVarIn, lpszFormat, rgbTok, dwFlags, pbstrOut, lcid);
2118 ERR("unrecognised format type 0x%02x\n", header->type);
2119 return E_INVALIDARG;
2121 /* If the coercion failed, still try to create output, unless the
2122 * VAR_FORMAT_NOSUBSTITUTE flag is set.
2124 if ((hres == DISP_E_OVERFLOW || hres == DISP_E_TYPEMISMATCH) &&
2125 !(dwFlags & VAR_FORMAT_NOSUBSTITUTE))
2126 goto VarFormatFromTokens_AsStr;
2132 /**********************************************************************
2133 * VarFormat [OLEAUT32.87]
2135 * Format a variant from a format string.
2138 * pVarIn [I] Variant to format
2139 * lpszFormat [I] Format string (see notes)
2140 * nFirstDay [I] First day of the week, (See VarTokenizeFormatString() for details)
2141 * nFirstWeek [I] First week of the year (See VarTokenizeFormatString() for details)
2142 * dwFlags [I] Flags for the format (VAR_ flags from "oleauto.h")
2143 * pbstrOut [O] Destination for formatted string.
2146 * Success: S_OK. pbstrOut contains the formatted value.
2147 * Failure: E_INVALIDARG, if any parameter is invalid.
2148 * E_OUTOFMEMORY, if enough memory cannot be allocated.
2149 * DISP_E_TYPEMISMATCH, if the variant cannot be formatted.
2152 * - See Variant-Formats for details concerning creating format strings.
2153 * - This function uses LOCALE_USER_DEFAULT when calling VarTokenizeFormatString()
2154 * and VarFormatFromTokens().
2156 HRESULT WINAPI VarFormat(LPVARIANT pVarIn, LPOLESTR lpszFormat,
2157 int nFirstDay, int nFirstWeek, ULONG dwFlags,
2163 TRACE("(%p->(%s%s),%s,%d,%d,0x%08x,%p)\n", pVarIn, debugstr_VT(pVarIn),
2164 debugstr_VF(pVarIn), debugstr_w(lpszFormat), nFirstDay, nFirstWeek,
2168 return E_INVALIDARG;
2171 hres = VarTokenizeFormatString(lpszFormat, buff, sizeof(buff), nFirstDay,
2172 nFirstWeek, LOCALE_USER_DEFAULT, NULL);
2173 if (SUCCEEDED(hres))
2174 hres = VarFormatFromTokens(pVarIn, lpszFormat, buff, dwFlags,
2175 pbstrOut, LOCALE_USER_DEFAULT);
2176 TRACE("returning 0x%08x, %s\n", hres, debugstr_w(*pbstrOut));
2180 /**********************************************************************
2181 * VarFormatDateTime [OLEAUT32.97]
2183 * Format a variant value as a date and/or time.
2186 * pVarIn [I] Variant to format
2187 * nFormat [I] Format type (see notes)
2188 * dwFlags [I] Flags for the format (VAR_ flags from "oleauto.h")
2189 * pbstrOut [O] Destination for formatted string.
2192 * Success: S_OK. pbstrOut contains the formatted value.
2193 * Failure: E_INVALIDARG, if any parameter is invalid.
2194 * E_OUTOFMEMORY, if enough memory cannot be allocated.
2195 * DISP_E_TYPEMISMATCH, if the variant cannot be formatted.
2198 * This function uses LOCALE_USER_DEFAULT when determining the date format
2199 * characters to use.
2200 * Possible values for the nFormat parameter are:
2203 *| 0 General date format
2204 *| 1 Long date format
2205 *| 2 Short date format
2206 *| 3 Long time format
2207 *| 4 Short time format
2209 HRESULT WINAPI VarFormatDateTime(LPVARIANT pVarIn, INT nFormat, ULONG dwFlags, BSTR *pbstrOut)
2211 static WCHAR szEmpty[] = { '\0' };
2212 const BYTE* lpFmt = NULL;
2214 TRACE("(%p->(%s%s),%d,0x%08x,%p)\n", pVarIn, debugstr_VT(pVarIn),
2215 debugstr_VF(pVarIn), nFormat, dwFlags, pbstrOut);
2217 if (!pVarIn || !pbstrOut || nFormat < 0 || nFormat > 4)
2218 return E_INVALIDARG;
2222 case 0: lpFmt = fmtGeneralDate; break;
2223 case 1: lpFmt = fmtLongDate; break;
2224 case 2: lpFmt = fmtShortDate; break;
2225 case 3: lpFmt = fmtLongTime; break;
2226 case 4: lpFmt = fmtShortTime; break;
2228 return VarFormatFromTokens(pVarIn, szEmpty, (BYTE*)lpFmt, dwFlags,
2229 pbstrOut, LOCALE_USER_DEFAULT);
2232 #define GETLOCALENUMBER(type,field) GetLocaleInfoW(LOCALE_USER_DEFAULT, \
2233 type|LOCALE_RETURN_NUMBER, \
2234 (LPWSTR)&numfmt.field, \
2235 sizeof(numfmt.field)/sizeof(WCHAR))
2237 /**********************************************************************
2238 * VarFormatNumber [OLEAUT32.107]
2240 * Format a variant value as a number.
2243 * pVarIn [I] Variant to format
2244 * nDigits [I] Number of digits following the decimal point (-1 = user default)
2245 * nLeading [I] Use a leading zero (-2 = user default, -1 = yes, 0 = no)
2246 * nParens [I] Use brackets for values < 0 (-2 = user default, -1 = yes, 0 = no)
2247 * nGrouping [I] Use grouping characters (-2 = user default, -1 = yes, 0 = no)
2248 * dwFlags [I] Currently unused, set to zero
2249 * pbstrOut [O] Destination for formatted string.
2252 * Success: S_OK. pbstrOut contains the formatted value.
2253 * Failure: E_INVALIDARG, if any parameter is invalid.
2254 * E_OUTOFMEMORY, if enough memory cannot be allocated.
2255 * DISP_E_TYPEMISMATCH, if the variant cannot be formatted.
2258 * This function uses LOCALE_USER_DEFAULT when determining the number format
2259 * characters to use.
2261 HRESULT WINAPI VarFormatNumber(LPVARIANT pVarIn, INT nDigits, INT nLeading, INT nParens,
2262 INT nGrouping, ULONG dwFlags, BSTR *pbstrOut)
2267 TRACE("(%p->(%s%s),%d,%d,%d,%d,0x%08x,%p)\n", pVarIn, debugstr_VT(pVarIn),
2268 debugstr_VF(pVarIn), nDigits, nLeading, nParens, nGrouping, dwFlags, pbstrOut);
2270 if (!pVarIn || !pbstrOut || nDigits > 9)
2271 return E_INVALIDARG;
2275 V_VT(&vStr) = VT_EMPTY;
2276 hRet = VariantCopyInd(&vStr, pVarIn);
2278 if (SUCCEEDED(hRet))
2279 hRet = VariantChangeTypeEx(&vStr, &vStr, LCID_US, 0, VT_BSTR);
2281 if (SUCCEEDED(hRet))
2283 WCHAR buff[256], decimal[8], thousands[8];
2286 /* Although MSDN makes it clear that the native versions of these functions
2287 * are implemented using VarTokenizeFormatString()/VarFormatFromTokens(),
2288 * using NLS gives us the same result.
2291 GETLOCALENUMBER(LOCALE_IDIGITS, NumDigits);
2293 numfmt.NumDigits = nDigits;
2296 GETLOCALENUMBER(LOCALE_ILZERO, LeadingZero);
2297 else if (nLeading == -1)
2298 numfmt.LeadingZero = 1;
2300 numfmt.LeadingZero = 0;
2302 if (nGrouping == -2)
2306 GetLocaleInfoW(LOCALE_USER_DEFAULT, LOCALE_SDECIMAL, grouping,
2307 sizeof(grouping)/sizeof(WCHAR));
2308 numfmt.Grouping = grouping[2] == '2' ? 32 : grouping[0] - '0';
2310 else if (nGrouping == -1)
2311 numfmt.Grouping = 3; /* 3 = "n,nnn.nn" */
2313 numfmt.Grouping = 0; /* 0 = No grouping */
2316 GETLOCALENUMBER(LOCALE_INEGNUMBER, NegativeOrder);
2317 else if (nParens == -1)
2318 numfmt.NegativeOrder = 0; /* 0 = "(xxx)" */
2320 numfmt.NegativeOrder = 1; /* 1 = "-xxx" */
2322 numfmt.lpDecimalSep = decimal;
2323 GetLocaleInfoW(LOCALE_USER_DEFAULT, LOCALE_SDECIMAL, decimal,
2324 sizeof(decimal)/sizeof(WCHAR));
2325 numfmt.lpThousandSep = thousands;
2326 GetLocaleInfoW(LOCALE_USER_DEFAULT, LOCALE_SDECIMAL, thousands,
2327 sizeof(thousands)/sizeof(WCHAR));
2329 if (GetNumberFormatW(LOCALE_USER_DEFAULT, 0, V_BSTR(&vStr), &numfmt,
2330 buff, sizeof(buff)/sizeof(WCHAR)))
2332 *pbstrOut = SysAllocString(buff);
2334 hRet = E_OUTOFMEMORY;
2337 hRet = DISP_E_TYPEMISMATCH;
2339 SysFreeString(V_BSTR(&vStr));
2344 /**********************************************************************
2345 * VarFormatPercent [OLEAUT32.117]
2347 * Format a variant value as a percentage.
2350 * pVarIn [I] Variant to format
2351 * nDigits [I] Number of digits following the decimal point (-1 = user default)
2352 * nLeading [I] Use a leading zero (-2 = user default, -1 = yes, 0 = no)
2353 * nParens [I] Use brackets for values < 0 (-2 = user default, -1 = yes, 0 = no)
2354 * nGrouping [I] Use grouping characters (-2 = user default, -1 = yes, 0 = no)
2355 * dwFlags [I] Currently unused, set to zero
2356 * pbstrOut [O] Destination for formatted string.
2359 * Success: S_OK. pbstrOut contains the formatted value.
2360 * Failure: E_INVALIDARG, if any parameter is invalid.
2361 * E_OUTOFMEMORY, if enough memory cannot be allocated.
2362 * DISP_E_OVERFLOW, if overflow occurs during the conversion.
2363 * DISP_E_TYPEMISMATCH, if the variant cannot be formatted.
2366 * This function uses LOCALE_USER_DEFAULT when determining the number format
2367 * characters to use.
2369 HRESULT WINAPI VarFormatPercent(LPVARIANT pVarIn, INT nDigits, INT nLeading, INT nParens,
2370 INT nGrouping, ULONG dwFlags, BSTR *pbstrOut)
2372 static const WCHAR szPercent[] = { '%','\0' };
2373 static const WCHAR szPercentBracket[] = { '%',')','\0' };
2378 TRACE("(%p->(%s%s),%d,%d,%d,%d,0x%08x,%p)\n", pVarIn, debugstr_VT(pVarIn),
2379 debugstr_VF(pVarIn), nDigits, nLeading, nParens, nGrouping,
2382 if (!pVarIn || !pbstrOut || nDigits > 9)
2383 return E_INVALIDARG;
2387 V_VT(&vDbl) = VT_EMPTY;
2388 hRet = VariantCopyInd(&vDbl, pVarIn);
2390 if (SUCCEEDED(hRet))
2392 hRet = VariantChangeTypeEx(&vDbl, &vDbl, LOCALE_USER_DEFAULT, 0, VT_R8);
2394 if (SUCCEEDED(hRet))
2396 if (V_R8(&vDbl) > (R8_MAX / 100.0))
2397 return DISP_E_OVERFLOW;
2399 V_R8(&vDbl) *= 100.0;
2400 hRet = VarFormatNumber(&vDbl, nDigits, nLeading, nParens,
2401 nGrouping, dwFlags, pbstrOut);
2403 if (SUCCEEDED(hRet))
2405 DWORD dwLen = strlenW(*pbstrOut);
2406 BOOL bBracket = (*pbstrOut)[dwLen] == ')' ? TRUE : FALSE;
2409 memcpy(buff, *pbstrOut, dwLen * sizeof(WCHAR));
2410 strcpyW(buff + dwLen, bBracket ? szPercentBracket : szPercent);
2411 SysFreeString(*pbstrOut);
2412 *pbstrOut = SysAllocString(buff);
2414 hRet = E_OUTOFMEMORY;
2421 /**********************************************************************
2422 * VarFormatCurrency [OLEAUT32.127]
2424 * Format a variant value as a currency.
2427 * pVarIn [I] Variant to format
2428 * nDigits [I] Number of digits following the decimal point (-1 = user default)
2429 * nLeading [I] Use a leading zero (-2 = user default, -1 = yes, 0 = no)
2430 * nParens [I] Use brackets for values < 0 (-2 = user default, -1 = yes, 0 = no)
2431 * nGrouping [I] Use grouping characters (-2 = user default, -1 = yes, 0 = no)
2432 * dwFlags [I] Currently unused, set to zero
2433 * pbstrOut [O] Destination for formatted string.
2436 * Success: S_OK. pbstrOut contains the formatted value.
2437 * Failure: E_INVALIDARG, if any parameter is invalid.
2438 * E_OUTOFMEMORY, if enough memory cannot be allocated.
2439 * DISP_E_TYPEMISMATCH, if the variant cannot be formatted.
2442 * This function uses LOCALE_USER_DEFAULT when determining the currency format
2443 * characters to use.
2445 HRESULT WINAPI VarFormatCurrency(LPVARIANT pVarIn, INT nDigits, INT nLeading,
2446 INT nParens, INT nGrouping, ULONG dwFlags,
2452 TRACE("(%p->(%s%s),%d,%d,%d,%d,0x%08x,%p)\n", pVarIn, debugstr_VT(pVarIn),
2453 debugstr_VF(pVarIn), nDigits, nLeading, nParens, nGrouping, dwFlags, pbstrOut);
2455 if (!pVarIn || !pbstrOut || nDigits > 9)
2456 return E_INVALIDARG;
2460 V_VT(&vStr) = VT_EMPTY;
2461 hRet = VariantCopyInd(&vStr, pVarIn);
2463 if (SUCCEEDED(hRet))
2464 hRet = VariantChangeTypeEx(&vStr, &vStr, LOCALE_USER_DEFAULT, 0, VT_BSTR);
2466 if (SUCCEEDED(hRet))
2468 WCHAR buff[256], decimal[8], thousands[8], currency[8];
2469 CURRENCYFMTW numfmt;
2472 GETLOCALENUMBER(LOCALE_IDIGITS, NumDigits);
2474 numfmt.NumDigits = nDigits;
2477 GETLOCALENUMBER(LOCALE_ILZERO, LeadingZero);
2478 else if (nLeading == -1)
2479 numfmt.LeadingZero = 1;
2481 numfmt.LeadingZero = 0;
2483 if (nGrouping == -2)
2485 WCHAR nGrouping[16];
2486 nGrouping[2] = '\0';
2487 GetLocaleInfoW(LOCALE_USER_DEFAULT, LOCALE_SDECIMAL, nGrouping,
2488 sizeof(nGrouping)/sizeof(WCHAR));
2489 numfmt.Grouping = nGrouping[2] == '2' ? 32 : nGrouping[0] - '0';
2491 else if (nGrouping == -1)
2492 numfmt.Grouping = 3; /* 3 = "n,nnn.nn" */
2494 numfmt.Grouping = 0; /* 0 = No grouping */
2497 GETLOCALENUMBER(LOCALE_INEGCURR, NegativeOrder);
2498 else if (nParens == -1)
2499 numfmt.NegativeOrder = 0; /* 0 = "(xxx)" */
2501 numfmt.NegativeOrder = 1; /* 1 = "-xxx" */
2503 GETLOCALENUMBER(LOCALE_ICURRENCY, PositiveOrder);
2505 numfmt.lpDecimalSep = decimal;
2506 GetLocaleInfoW(LOCALE_USER_DEFAULT, LOCALE_SDECIMAL, decimal,
2507 sizeof(decimal)/sizeof(WCHAR));
2508 numfmt.lpThousandSep = thousands;
2509 GetLocaleInfoW(LOCALE_USER_DEFAULT, LOCALE_SDECIMAL, thousands,
2510 sizeof(thousands)/sizeof(WCHAR));
2511 numfmt.lpCurrencySymbol = currency;
2512 GetLocaleInfoW(LOCALE_USER_DEFAULT, LOCALE_SDECIMAL, currency,
2513 sizeof(currency)/sizeof(WCHAR));
2515 /* use NLS as per VarFormatNumber() */
2516 if (GetCurrencyFormatW(LOCALE_USER_DEFAULT, 0, V_BSTR(&vStr), &numfmt,
2517 buff, sizeof(buff)/sizeof(WCHAR)))
2519 *pbstrOut = SysAllocString(buff);
2521 hRet = E_OUTOFMEMORY;
2524 hRet = DISP_E_TYPEMISMATCH;
2526 SysFreeString(V_BSTR(&vStr));
2531 /**********************************************************************
2532 * VarMonthName [OLEAUT32.129]
2534 * Print the specified month as localized name.
2537 * iMonth [I] month number 1..12
2538 * fAbbrev [I] 0 - full name, !0 - abbreviated name
2539 * dwFlags [I] flag stuff. only VAR_CALENDAR_HIJRI possible.
2540 * pbstrOut [O] Destination for month name
2543 * Success: S_OK. pbstrOut contains the name.
2544 * Failure: E_INVALIDARG, if any parameter is invalid.
2545 * E_OUTOFMEMORY, if enough memory cannot be allocated.
2547 HRESULT WINAPI VarMonthName(INT iMonth, INT fAbbrev, ULONG dwFlags, BSTR *pbstrOut)
2552 if ((iMonth < 1) || (iMonth > 12))
2553 return E_INVALIDARG;
2556 FIXME("Does not support dwFlags 0x%x, ignoring.\n", dwFlags);
2559 localeValue = LOCALE_SABBREVMONTHNAME1 + iMonth - 1;
2561 localeValue = LOCALE_SMONTHNAME1 + iMonth - 1;
2563 size = GetLocaleInfoW(LOCALE_USER_DEFAULT,localeValue, NULL, 0);
2565 ERR("GetLocaleInfo 0x%x failed.\n", localeValue);
2566 return HRESULT_FROM_WIN32(GetLastError());
2568 *pbstrOut = SysAllocStringLen(NULL,size - 1);
2570 return E_OUTOFMEMORY;
2571 size = GetLocaleInfoW(LOCALE_USER_DEFAULT,localeValue, *pbstrOut, size);
2573 ERR("GetLocaleInfo of 0x%x failed in 2nd stage?!\n", localeValue);
2574 SysFreeString(*pbstrOut);
2575 return HRESULT_FROM_WIN32(GetLastError());
2580 /**********************************************************************
2581 * VarWeekdayName [OLEAUT32.129]
2583 * Print the specified weekday as localized name.
2586 * iWeekday [I] day of week, 1..7, 1="the first day of the week"
2587 * fAbbrev [I] 0 - full name, !0 - abbreviated name
2588 * iFirstDay [I] first day of week,
2589 * 0=system default, 1=Sunday, 2=Monday, .. (contrary to MSDN)
2590 * dwFlags [I] flag stuff. only VAR_CALENDAR_HIJRI possible.
2591 * pbstrOut [O] Destination for weekday name.
2594 * Success: S_OK, pbstrOut contains the name.
2595 * Failure: E_INVALIDARG, if any parameter is invalid.
2596 * E_OUTOFMEMORY, if enough memory cannot be allocated.
2598 HRESULT WINAPI VarWeekdayName(INT iWeekday, INT fAbbrev, INT iFirstDay,
2599 ULONG dwFlags, BSTR *pbstrOut)
2604 /* Windows XP oleaut32.dll doesn't allow iWekday==0, contrary to MSDN */
2605 if (iWeekday < 1 || iWeekday > 7)
2606 return E_INVALIDARG;
2607 if (iFirstDay < 0 || iFirstDay > 7)
2608 return E_INVALIDARG;
2610 return E_INVALIDARG;
2613 FIXME("Does not support dwFlags 0x%x, ignoring.\n", dwFlags);
2615 /* If we have to use the default firstDay, find which one it is */
2616 if (iFirstDay == 0) {
2618 localeValue = LOCALE_RETURN_NUMBER | LOCALE_IFIRSTDAYOFWEEK;
2619 size = GetLocaleInfoW(LOCALE_USER_DEFAULT, localeValue,
2620 (LPWSTR)&firstDay, sizeof(firstDay) / sizeof(WCHAR));
2622 ERR("GetLocaleInfo 0x%x failed.\n", localeValue);
2623 return HRESULT_FROM_WIN32(GetLastError());
2625 iFirstDay = firstDay + 2;
2628 /* Determine what we need to return */
2629 localeValue = fAbbrev ? LOCALE_SABBREVDAYNAME1 : LOCALE_SDAYNAME1;
2630 localeValue += (7 + iWeekday - 1 + iFirstDay - 2) % 7;
2632 /* Determine the size of the data, allocate memory and retrieve the data */
2633 size = GetLocaleInfoW(LOCALE_USER_DEFAULT, localeValue, NULL, 0);
2635 ERR("GetLocaleInfo 0x%x failed.\n", localeValue);
2636 return HRESULT_FROM_WIN32(GetLastError());
2638 *pbstrOut = SysAllocStringLen(NULL, size - 1);
2640 return E_OUTOFMEMORY;
2641 size = GetLocaleInfoW(LOCALE_USER_DEFAULT, localeValue, *pbstrOut, size);
2643 ERR("GetLocaleInfo 0x%x failed in 2nd stage?!\n", localeValue);
2644 SysFreeString(*pbstrOut);
2645 return HRESULT_FROM_WIN32(GetLastError());