Subversion Repositories HelenOS

Rev

Rev 4207 | Rev 4210 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
1271 cejka 1
/*
2071 jermar 2
 * Copyright (c) 2001-2004 Jakub Jermar
3
 * Copyright (c) 2006 Josef Cejka
4180 decky 4
 * Copyright (c) 2009 Martin Decky
1271 cejka 5
 * All rights reserved.
6
 *
7
 * Redistribution and use in source and binary forms, with or without
8
 * modification, are permitted provided that the following conditions
9
 * are met:
10
 *
11
 * - Redistributions of source code must retain the above copyright
12
 *   notice, this list of conditions and the following disclaimer.
13
 * - Redistributions in binary form must reproduce the above copyright
14
 *   notice, this list of conditions and the following disclaimer in the
15
 *   documentation and/or other materials provided with the distribution.
16
 * - The name of the author may not be used to endorse or promote products
17
 *   derived from this software without specific prior written permission.
18
 *
19
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
20
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
23
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
24
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29
 */
30
 
4180 decky 31
/** @addtogroup generic
1702 cejka 32
 * @{
33
 */
1271 cejka 34
/**
1702 cejka 35
 * @file
4180 decky 36
 * @brief Printing functions.
1271 cejka 37
 */
38
 
39
#include <printf/printf_core.h>
40
#include <print.h>
41
#include <arch/arg.h>
2572 jermar 42
#include <macros.h>
4011 svoboda 43
#include <string.h>
1271 cejka 44
#include <arch.h>
45
 
2572 jermar 46
/** show prefixes 0x or 0 */
4180 decky 47
#define __PRINTF_FLAG_PREFIX       0x00000001
2572 jermar 48
/** signed / unsigned number */
4180 decky 49
#define __PRINTF_FLAG_SIGNED       0x00000002
2572 jermar 50
/** print leading zeroes */
4180 decky 51
#define __PRINTF_FLAG_ZEROPADDED   0x00000004
2572 jermar 52
/** align to left */
4180 decky 53
#define __PRINTF_FLAG_LEFTALIGNED  0x00000010
2572 jermar 54
/** always show + sign */
4180 decky 55
#define __PRINTF_FLAG_SHOWPLUS     0x00000020
2572 jermar 56
/** print space instead of plus */
4180 decky 57
#define __PRINTF_FLAG_SPACESIGN    0x00000040
2572 jermar 58
/** show big characters */
4180 decky 59
#define __PRINTF_FLAG_BIGCHARS     0x00000080
2572 jermar 60
/** number has - sign */
4180 decky 61
#define __PRINTF_FLAG_NEGATIVE     0x00000100
1271 cejka 62
 
2572 jermar 63
/**
64
 * Buffer big enough for 64-bit number printed in base 2, sign, prefix and 0
65
 * to terminate string... (last one is only for better testing end of buffer by
66
 * zero-filling subroutine)
67
 */
4180 decky 68
#define PRINT_NUMBER_BUFFER_SIZE  (64 + 5)
1271 cejka 69
 
70
/** Enumeration of possible arguments types.
71
 */
72
typedef enum {
73
    PrintfQualifierByte = 0,
74
    PrintfQualifierShort,
75
    PrintfQualifierInt,
76
    PrintfQualifierLong,
77
    PrintfQualifierLongLong,
78
    PrintfQualifierPointer
79
} qualifier_t;
80
 
4180 decky 81
static char nullstr[] = "(NULL)";
2572 jermar 82
static char digits_small[] = "0123456789abcdef";
83
static char digits_big[] = "0123456789ABCDEF";
1271 cejka 84
 
4180 decky 85
/** Print one or more UTF-8 characters without adding newline.
2572 jermar 86
 *
4180 decky 87
 * @param buf  Buffer holding UTF-8 characters with size of
88
 *             at least size bytes. NULL is not allowed!
89
 * @param size Size of the buffer in bytes.
90
 * @param ps   Output method and its data.
91
 *
92
 * @return Number of UTF-8 characters printed.
93
 *
1271 cejka 94
 */
4180 decky 95
static int printf_putnchars_utf8(const char *buf, size_t size,
96
    printf_spec_t *ps)
1271 cejka 97
{
4180 decky 98
    return ps->write_utf8((void *) buf, size, ps->data);
1271 cejka 99
}
100
 
4180 decky 101
/** Print one or more UTF-32 characters without adding newline.
2572 jermar 102
 *
4180 decky 103
 * @param buf  Buffer holding UTF-32 characters with size of
104
 *             at least size bytes. NULL is not allowed!
105
 * @param size Size of the buffer in bytes.
106
 * @param ps   Output method and its data.
107
 *
108
 * @return Number of UTF-32 characters printed.
109
 *
1271 cejka 110
 */
4180 decky 111
static int printf_putnchars_utf32(const wchar_t *buf, size_t size,
112
    printf_spec_t *ps)
1271 cejka 113
{
4180 decky 114
    return ps->write_utf32((void *) buf, size, ps->data);
115
}
116
 
117
/** Print UTF-8 string without adding a newline.
118
 *
119
 * @param str UTF-8 string to print.
120
 * @param ps  Write function specification and support data.
121
 *
122
 * @return Number of UTF-8 characters printed.
123
 *
124
 */
125
static int printf_putstr(const char *str, printf_spec_t *ps)
126
{
127
    if (str == NULL)
4207 svoboda 128
        return printf_putnchars_utf8(nullstr, str_size(nullstr), ps);
1271 cejka 129
 
4207 svoboda 130
    return ps->write_utf8((void *) str, str_size(str), ps->data);
4180 decky 131
}
1271 cejka 132
 
4180 decky 133
/** Print one ASCII character.
134
 *
135
 * @param c  ASCII character to be printed.
136
 * @param ps Output method.
137
 *
138
 * @return Number of characters printed.
139
 *
140
 */
141
static int printf_putchar(const char ch, printf_spec_t *ps)
142
{
143
    if (!ascii_check(ch))
144
        return ps->write_utf8((void *) &invalch, 1, ps->data);
145
 
146
    return ps->write_utf8(&ch, 1, ps->data);
1271 cejka 147
}
148
 
4180 decky 149
/** Print one UTF-32 character.
2572 jermar 150
 *
4180 decky 151
 * @param c  UTF-32 character to be printed.
152
 * @param ps Output method.
2572 jermar 153
 *
4180 decky 154
 * @return Number of characters printed.
155
 *
1271 cejka 156
 */
4180 decky 157
static int printf_putwchar(const wchar_t ch, printf_spec_t *ps)
1271 cejka 158
{
4180 decky 159
    if (!unicode_check(ch))
160
        return ps->write_utf8((void *) &invalch, 1, ps->data);
1271 cejka 161
 
4185 decky 162
    return ps->write_utf32(&ch, sizeof(wchar_t), ps->data);
1271 cejka 163
}
164
 
4180 decky 165
/** Print one formatted ASCII character.
2572 jermar 166
 *
4180 decky 167
 * @param ch    Character to print.
168
 * @param width Width modifier.
169
 * @param flags Flags that change the way the character is printed.
2572 jermar 170
 *
4180 decky 171
 * @return Number of characters printed, negative value on failure.
172
 *
1271 cejka 173
 */
4180 decky 174
static int print_char(const char ch, int width, uint32_t flags, printf_spec_t *ps)
1271 cejka 175
{
4180 decky 176
    count_t counter = 0;
1271 cejka 177
    if (!(flags & __PRINTF_FLAG_LEFTALIGNED)) {
2572 jermar 178
        while (--width > 0) {
179
            /*
180
             * One space is consumed by the character itself, hence
181
             * the predecrement.
182
             */
4180 decky 183
            if (printf_putchar(' ', ps) > 0)
184
                counter++;
1271 cejka 185
        }
186
    }
187
 
4180 decky 188
    if (printf_putchar(ch, ps) > 0)
1604 cejka 189
        counter++;
4180 decky 190
 
191
    while (--width > 0) {
192
        /*
193
         * One space is consumed by the character itself, hence
194
         * the predecrement.
195
         */
196
        if (printf_putchar(' ', ps) > 0)
197
            counter++;
198
    }
199
 
200
    return (int) (counter + 1);
201
}
1271 cejka 202
 
4180 decky 203
/** Print one formatted UTF-32 character.
204
 *
205
 * @param ch    Character to print.
206
 * @param width Width modifier.
207
 * @param flags Flags that change the way the character is printed.
208
 *
209
 * @return Number of characters printed, negative value on failure.
210
 *
211
 */
212
static int print_wchar(const wchar_t ch, int width, uint32_t flags, printf_spec_t *ps)
213
{
214
    count_t counter = 0;
215
    if (!(flags & __PRINTF_FLAG_LEFTALIGNED)) {
216
        while (--width > 0) {
2572 jermar 217
            /*
218
             * One space is consumed by the character itself, hence
219
             * the predecrement.
220
             */
4180 decky 221
            if (printf_putchar(' ', ps) > 0)
222
                counter++;
223
        }
224
    }
225
 
226
    if (printf_putwchar(ch, ps) > 0)
227
        counter++;
228
 
229
    while (--width > 0) {
230
        /*
231
         * One space is consumed by the character itself, hence
232
         * the predecrement.
233
         */
1604 cejka 234
        if (printf_putchar(' ', ps) > 0)
4180 decky 235
            counter++;
1271 cejka 236
    }
237
 
4180 decky 238
    return (int) (counter + 1);
1271 cejka 239
}
240
 
4180 decky 241
/** Print UTF-8 string.
2572 jermar 242
 *
4180 decky 243
 * @param str       UTF-8 string to be printed.
244
 * @param width     Width modifier.
245
 * @param precision Precision modifier.
246
 * @param flags     Flags that modify the way the string is printed.
2572 jermar 247
 *
4180 decky 248
 * @return Number of UTF-8 characters printed, negative value on failure.
249
 */
250
static int print_utf8(char *str, int width, unsigned int precision,
251
    uint32_t flags, printf_spec_t *ps)
1271 cejka 252
{
4180 decky 253
    if (str == NULL)
254
        return printf_putstr(nullstr, ps);
4206 svoboda 255
 
256
    /* Print leading spaces. */
257
    count_t strw = str_length(str);
4180 decky 258
    if (precision == 0)
4206 svoboda 259
        precision = strw;
4199 svoboda 260
 
4180 decky 261
    count_t counter = 0;
262
    width -= precision;
263
    if (!(flags & __PRINTF_FLAG_LEFTALIGNED)) {
264
        while (width-- > 0) {
265
            if (printf_putchar(' ', ps) == 1)
266
                counter++;
267
        }
268
    }
4199 svoboda 269
 
1604 cejka 270
    int retval;
4209 svoboda 271
    size_t size = str_wsize(str, precision);
4206 svoboda 272
    if ((retval = printf_putnchars_utf8(str, size, ps)) < 0)
4180 decky 273
        return -counter;
4206 svoboda 274
 
4180 decky 275
    counter += retval;
4206 svoboda 276
 
4180 decky 277
    while (width-- > 0) {
278
        if (printf_putchar(' ', ps) == 1)
279
            counter++;
1271 cejka 280
    }
4199 svoboda 281
 
4180 decky 282
    return ((int) counter);
4206 svoboda 283
 
4180 decky 284
}
1271 cejka 285
 
4180 decky 286
/** Print UTF-32 string.
287
 *
288
 * @param str       UTF-32 string to be printed.
289
 * @param width     Width modifier.
290
 * @param precision Precision modifier.
291
 * @param flags     Flags that modify the way the string is printed.
292
 *
293
 * @return Number of UTF-32 characters printed, negative value on failure.
294
 */
4206 svoboda 295
static int print_utf32(wchar_t *wstr, int width, unsigned int precision,
4180 decky 296
    uint32_t flags, printf_spec_t *ps)
297
{
4206 svoboda 298
    if (wstr == NULL)
4180 decky 299
        return printf_putstr(nullstr, ps);
4206 svoboda 300
 
301
    /* Print leading spaces. */
302
    size_t strw = wstr_length(wstr);
4180 decky 303
    if (precision == 0)
4206 svoboda 304
        precision = strw;
305
 
4180 decky 306
    count_t counter = 0;
1271 cejka 307
    width -= precision;
308
    if (!(flags & __PRINTF_FLAG_LEFTALIGNED)) {
4180 decky 309
        while (width-- > 0) {
310
            if (printf_putchar(' ', ps) == 1)
1604 cejka 311
                counter++;
1271 cejka 312
        }
313
    }
4206 svoboda 314
 
4180 decky 315
    int retval;
4209 svoboda 316
    size_t size = wstr_wlength(wstr, precision) * sizeof(wchar_t);
4206 svoboda 317
    if ((retval = printf_putnchars_utf32(wstr, size, ps)) < 0)
1604 cejka 318
        return -counter;
4206 svoboda 319
 
4180 decky 320
    counter += retval;
4206 svoboda 321
 
1271 cejka 322
    while (width-- > 0) {
4180 decky 323
        if (printf_putchar(' ', ps) == 1)
324
            counter++;
1271 cejka 325
    }
4206 svoboda 326
 
4180 decky 327
    return ((int) counter);
1271 cejka 328
}
329
 
2572 jermar 330
/** Print a number in a given base.
1271 cejka 331
 *
2572 jermar 332
 * Print significant digits of a number in given base.
1271 cejka 333
 *
4180 decky 334
 * @param num       Number to print.
335
 * @param width     Width modifier.
336
 * @param precision Precision modifier.
337
 * @param base      Base to print the number in (must be between 2 and 16).
338
 * @param flags     Flags that modify the way the number is printed.
1271 cejka 339
 *
4180 decky 340
 * @return Number of characters printed.
2572 jermar 341
 *
1271 cejka 342
 */
2572 jermar 343
static int print_number(uint64_t num, int width, int precision, int base,
4180 decky 344
    uint32_t flags, printf_spec_t *ps)
1271 cejka 345
{
4180 decky 346
    char *digits;
347
    if (flags & __PRINTF_FLAG_BIGCHARS)
348
        digits = digits_big;
349
    else
350
        digits = digits_small;
1271 cejka 351
 
4180 decky 352
    char data[PRINT_NUMBER_BUFFER_SIZE];
353
    char *ptr = &data[PRINT_NUMBER_BUFFER_SIZE - 1];
1271 cejka 354
 
4180 decky 355
    /* Size of number with all prefixes and signs */
356
    int size = 0;
357
 
358
    /* Put zero at end of string */
359
    *ptr-- = 0;
360
 
1271 cejka 361
    if (num == 0) {
362
        *ptr-- = '0';
363
        size++;
364
    } else {
365
        do {
366
            *ptr-- = digits[num % base];
367
            size++;
368
        } while (num /= base);
369
    }
370
 
4180 decky 371
    /* Size of plain number */
372
    int number_size = size;
373
 
2572 jermar 374
    /*
4180 decky 375
     * Collect the sum of all prefixes/signs/etc. to calculate padding and
2572 jermar 376
     * leading zeroes.
377
     */
1271 cejka 378
    if (flags & __PRINTF_FLAG_PREFIX) {
379
        switch(base) {
4180 decky 380
        case 2:
381
            /* Binary formating is not standard, but usefull */
2070 jermar 382
            size += 2;
383
            break;
384
        case 8:
385
            size++;
386
            break;
387
        case 16:
388
            size += 2;
389
            break;
1271 cejka 390
        }
391
    }
4180 decky 392
 
393
    char sgn = 0;
1271 cejka 394
    if (flags & __PRINTF_FLAG_SIGNED) {
395
        if (flags & __PRINTF_FLAG_NEGATIVE) {
396
            sgn = '-';
397
            size++;
398
        } else if (flags & __PRINTF_FLAG_SHOWPLUS) {
2572 jermar 399
            sgn = '+';
400
            size++;
401
        } else if (flags & __PRINTF_FLAG_SPACESIGN) {
402
            sgn = ' ';
403
            size++;
404
        }
1271 cejka 405
    }
4180 decky 406
 
407
    if (flags & __PRINTF_FLAG_LEFTALIGNED)
1271 cejka 408
        flags &= ~__PRINTF_FLAG_ZEROPADDED;
4180 decky 409
 
2572 jermar 410
    /*
4180 decky 411
     * If the number is left-aligned or precision is specified then
412
     * padding with zeros is ignored.
2572 jermar 413
     */
1271 cejka 414
    if (flags & __PRINTF_FLAG_ZEROPADDED) {
4180 decky 415
        if ((precision == 0) && (width > size))
1271 cejka 416
            precision = width - size + number_size;
417
    }
4180 decky 418
 
419
    /* Print leading spaces */
2572 jermar 420
    if (number_size > precision) {
4180 decky 421
        /* Print the whole number, not only a part */
1271 cejka 422
        precision = number_size;
2572 jermar 423
    }
4180 decky 424
 
1271 cejka 425
    width -= precision + size - number_size;
4180 decky 426
    count_t counter = 0;
1271 cejka 427
 
428
    if (!(flags & __PRINTF_FLAG_LEFTALIGNED)) {
4180 decky 429
        while (width-- > 0) {
430
            if (printf_putchar(' ', ps) == 1)
1604 cejka 431
                counter++;
1271 cejka 432
        }
433
    }
434
 
4180 decky 435
    /* Print sign */
1271 cejka 436
    if (sgn) {
1604 cejka 437
        if (printf_putchar(sgn, ps) == 1)
438
            counter++;
1271 cejka 439
    }
440
 
4180 decky 441
    /* Print prefix */
1271 cejka 442
    if (flags & __PRINTF_FLAG_PREFIX) {
443
        switch(base) {
4180 decky 444
        case 2:
445
            /* Binary formating is not standard, but usefull */
2070 jermar 446
            if (printf_putchar('0', ps) == 1)
447
                counter++;
448
            if (flags & __PRINTF_FLAG_BIGCHARS) {
449
                if (printf_putchar('B', ps) == 1)
1604 cejka 450
                    counter++;
2070 jermar 451
            } else {
452
                if (printf_putchar('b', ps) == 1)
1604 cejka 453
                    counter++;
2070 jermar 454
            }
455
            break;
456
        case 8:
457
            if (printf_putchar('o', ps) == 1)
458
                counter++;
459
            break;
460
        case 16:
461
            if (printf_putchar('0', ps) == 1)
462
                counter++;
463
            if (flags & __PRINTF_FLAG_BIGCHARS) {
464
                if (printf_putchar('X', ps) == 1)
1604 cejka 465
                    counter++;
2070 jermar 466
            } else {
467
                if (printf_putchar('x', ps) == 1)
468
                    counter++;
469
            }
470
            break;
1271 cejka 471
        }
472
    }
4180 decky 473
 
474
    /* Print leading zeroes */
1271 cejka 475
    precision -= number_size;
4180 decky 476
    while (precision-- > 0) {
1604 cejka 477
        if (printf_putchar('0', ps) == 1)
478
            counter++;
1271 cejka 479
    }
480
 
4180 decky 481
    /* Print the number itself */
482
    int retval;
483
    if ((retval = printf_putstr(++ptr, ps)) > 0)
1604 cejka 484
        counter += retval;
1271 cejka 485
 
4180 decky 486
    /* Print tailing spaces */
1271 cejka 487
 
4180 decky 488
    while (width-- > 0) {
489
        if (printf_putchar(' ', ps) == 1)
1604 cejka 490
            counter++;
1271 cejka 491
    }
4180 decky 492
 
493
    return ((int) counter);
1271 cejka 494
}
495
 
496
/** Print formatted string.
497
 *
2572 jermar 498
 * Print string formatted according to the fmt parameter and variadic arguments.
499
 * Each formatting directive must have the following form:
1271 cejka 500
 *
4180 decky 501
 *  \% [ FLAGS ] [ WIDTH ] [ .PRECISION ] [ TYPE ] CONVERSION
502
 *
1271 cejka 503
 * FLAGS:@n
4180 decky 504
 *  - "#" Force to print prefix. For \%o conversion, the prefix is 0, for
505
 *        \%x and \%X prefixes are 0x and 0X and for conversion \%b the
506
 *        prefix is 0b.
1271 cejka 507
 *
4180 decky 508
 *  - "-" Align to left.
1271 cejka 509
 *
4180 decky 510
 *  - "+" Print positive sign just as negative.
1271 cejka 511
 *
4180 decky 512
 *  - " " If the printed number is positive and "+" flag is not set,
513
 *        print space in place of sign.
1271 cejka 514
 *
4180 decky 515
 *  - "0" Print 0 as padding instead of spaces. Zeroes are placed between
516
 *        sign and the rest of the number. This flag is ignored if "-"
517
 *        flag is specified.
518
 *
1271 cejka 519
 * WIDTH:@n
4180 decky 520
 *  - Specify the minimal width of a printed argument. If it is bigger,
521
 *    width is ignored. If width is specified with a "*" character instead of
522
 *    number, width is taken from parameter list. And integer parameter is
523
 *    expected before parameter for processed conversion specification. If
524
 *    this value is negative its absolute value is taken and the "-" flag is
525
 *    set.
1271 cejka 526
 *
527
 * PRECISION:@n
4180 decky 528
 *  - Value precision. For numbers it specifies minimum valid numbers.
529
 *    Smaller numbers are printed with leading zeroes. Bigger numbers are not
530
 *    affected. Strings with more than precision characters are cut off. Just
531
 *    as with width, an "*" can be used used instead of a number. An integer
532
 *    value is then expected in parameters. When both width and precision are
533
 *    specified using "*", the first parameter is used for width and the
534
 *    second one for precision.
535
 *
1271 cejka 536
 * TYPE:@n
4180 decky 537
 *  - "hh" Signed or unsigned char.@n
538
 *  - "h"  Signed or unsigned short.@n
539
 *  - ""   Signed or unsigned int (default value).@n
540
 *  - "l"  Signed or unsigned long int.@n
541
 *         If conversion is "c", the character is wchar_t (UTF-32).@n
542
 *         If conversion is "s", the string is wchar_t * (UTF-32).@n
543
 *  - "ll" Signed or unsigned long long int.@n
544
 *
1271 cejka 545
 * CONVERSION:@n
4180 decky 546
 *  - % Print percentile character itself.
1271 cejka 547
 *
4180 decky 548
 *  - c Print single character. The character is expected to be plain
549
 *      ASCII (e.g. only values 0 .. 127 are valid).@n
550
 *      If type is "l", then the character is expected to be UTF-32
551
 *      (e.g. values 0 .. 0x10ffff are valid).
1271 cejka 552
 *
4180 decky 553
 *  - s Print zero terminated string. If a NULL value is passed as
554
 *      value, "(NULL)" is printed instead.@n
555
 *      The string is expected to be correctly encoded UTF-8 (or plain
556
 *      ASCII, which is a subset of UTF-8).@n
557
 *      If type is "l", then the string is expected to be correctly
558
 *      encoded UTF-32.
1271 cejka 559
 *
4180 decky 560
 *  - P, p Print value of a pointer. Void * value is expected and it is
561
 *         printed in hexadecimal notation with prefix (as with \%#X / \%#x
562
 *         for 32-bit or \%#X / \%#x for 64-bit long pointers).
1271 cejka 563
 *
4180 decky 564
 *  - b Print value as unsigned binary number. Prefix is not printed by
565
 *      default. (Nonstandard extension.)
1271 cejka 566
 *
4180 decky 567
 *  - o Print value as unsigned octal number. Prefix is not printed by
568
 *      default.
1271 cejka 569
 *
4180 decky 570
 *  - d, i Print signed decimal number. There is no difference between d
571
 *         and i conversion.
572
 *
573
 *  - u Print unsigned decimal number.
574
 *
575
 *  - X, x Print hexadecimal number with upper- or lower-case. Prefix is
576
 *         not printed by default.
577
 *
2572 jermar 578
 * All other characters from fmt except the formatting directives are printed in
579
 * verbatim.
1271 cejka 580
 *
4180 decky 581
 * @param fmt Formatting NULL terminated string (UTF-8 or plain ASCII).
582
 *
583
 * @return Number of UTF-8 characters printed, negative value on failure.
584
 *
1271 cejka 585
 */
4180 decky 586
int printf_core(const char *fmt, printf_spec_t *ps, va_list ap)
1271 cejka 587
{
4206 svoboda 588
    size_t i = 0;  /* Index of the currently processed character from fmt */
589
    size_t nxt = 0;
590
    size_t j = 0;  /* Index to the first not printed nonformating character */
1271 cejka 591
 
4180 decky 592
    wchar_t uc;           /* Current UTF-32 character decoded from fmt */
593
    count_t counter = 0;  /* Number of UTF-8 characters printed */
594
    int retval;           /* Return values from nested functions */
595
 
4199 svoboda 596
    while (true) {
597
        i = nxt;
4200 svoboda 598
        uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
4199 svoboda 599
 
600
        if (uc == '\0') break;
601
 
4180 decky 602
        /* Control character */
603
        if (uc == '%') {
604
            /* Print common characters if any processed */
1271 cejka 605
            if (i > j) {
4180 decky 606
                if ((retval = printf_putnchars_utf8(&fmt[j], i - j, ps)) < 0) {
607
                    /* Error */
1271 cejka 608
                    counter = -counter;
609
                    goto out;
610
                }
611
                counter += retval;
612
            }
4180 decky 613
 
1271 cejka 614
            j = i;
615
 
4180 decky 616
            /* Parse modifiers */
617
            uint32_t flags = 0;
618
            bool end = false;
619
 
1271 cejka 620
            do {
4199 svoboda 621
                i = nxt;
4200 svoboda 622
                uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
4183 decky 623
                switch (uc) {
2572 jermar 624
                case '#':
625
                    flags |= __PRINTF_FLAG_PREFIX;
626
                    break;
627
                case '-':
628
                    flags |= __PRINTF_FLAG_LEFTALIGNED;
629
                    break;
630
                case '+':
631
                    flags |= __PRINTF_FLAG_SHOWPLUS;
632
                    break;
633
                case ' ':
634
                    flags |= __PRINTF_FLAG_SPACESIGN;
635
                    break;
636
                case '0':
637
                    flags |= __PRINTF_FLAG_ZEROPADDED;
638
                    break;
639
                default:
4180 decky 640
                    end = true;
641
                };
642
            } while (!end);
1271 cejka 643
 
4180 decky 644
            /* Width & '*' operator */
645
            int width = 0;
646
            if (isdigit(uc)) {
4199 svoboda 647
                while (true) {
648
                    width *= 10;
649
                    width += uc - '0';
650
 
651
                    i = nxt;
4200 svoboda 652
                    uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
4199 svoboda 653
                    if (uc == '\0')
654
                        break;
4180 decky 655
                    if (!isdigit(uc))
656
                        break;
1271 cejka 657
                }
4180 decky 658
            } else if (uc == '*') {
659
                /* Get width value from argument list */
4199 svoboda 660
                i = nxt;
4200 svoboda 661
                uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
3058 decky 662
                width = (int) va_arg(ap, int);
1271 cejka 663
                if (width < 0) {
4180 decky 664
                    /* Negative width sets '-' flag */
1271 cejka 665
                    width *= -1;
666
                    flags |= __PRINTF_FLAG_LEFTALIGNED;
667
                }
668
            }
669
 
4180 decky 670
            /* Precision and '*' operator */
671
            int precision = 0;
672
            if (uc == '.') {
4199 svoboda 673
                i = nxt;
4200 svoboda 674
                uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
4180 decky 675
                if (isdigit(uc)) {
4199 svoboda 676
                    while (true) {
677
                        precision *= 10;
678
                        precision += uc - '0';
679
 
680
                        i = nxt;
4200 svoboda 681
                        uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
4199 svoboda 682
                        if (uc == '\0')
683
                            break;
4180 decky 684
                        if (!isdigit(uc))
685
                            break;
1271 cejka 686
                    }
4199 svoboda 687
                } else if (uc == '*') {
4180 decky 688
                    /* Get precision value from the argument list */
4199 svoboda 689
                    i = nxt;
4200 svoboda 690
                    uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
3058 decky 691
                    precision = (int) va_arg(ap, int);
1271 cejka 692
                    if (precision < 0) {
4180 decky 693
                        /* Ignore negative precision */
1271 cejka 694
                        precision = 0;
695
                    }
696
                }
697
            }
4180 decky 698
 
699
            qualifier_t qualifier;
700
 
701
            switch (uc) {
702
            /** @todo Unimplemented qualifiers:
703
             *        t ptrdiff_t - ISO C 99
1888 jermar 704
             */
4180 decky 705
            case 'h':
706
                /* Char or short */
1888 jermar 707
                qualifier = PrintfQualifierShort;
4199 svoboda 708
                i = nxt;
4200 svoboda 709
                uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
4180 decky 710
                if (uc == 'h') {
4199 svoboda 711
                    i = nxt;
4200 svoboda 712
                    uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
1888 jermar 713
                    qualifier = PrintfQualifierByte;
714
                }
715
                break;
4180 decky 716
            case 'l':
717
                /* Long or long long */
1888 jermar 718
                qualifier = PrintfQualifierLong;
4199 svoboda 719
                i = nxt;
4200 svoboda 720
                uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
4180 decky 721
                if (uc == 'l') {
4199 svoboda 722
                    i = nxt;
4200 svoboda 723
                    uc = chr_decode(fmt, &nxt, UTF8_NO_LIMIT);
1888 jermar 724
                    qualifier = PrintfQualifierLongLong;
725
                }
726
                break;
727
            default:
4180 decky 728
                /* Default type */
729
                qualifier = PrintfQualifierInt;
730
            }
1271 cejka 731
 
4180 decky 732
            unsigned int base = 10;
733
 
734
            switch (uc) {
1888 jermar 735
            /*
4180 decky 736
             * String and character conversions.
737
             */
1888 jermar 738
            case 's':
4180 decky 739
                if (qualifier == PrintfQualifierLong)
740
                    retval = print_utf32(va_arg(ap, wchar_t *), width, precision, flags, ps);
741
                else
742
                    retval = print_utf8(va_arg(ap, char *), width, precision, flags, ps);
743
 
744
                if (retval < 0) {
1888 jermar 745
                    counter = -counter;
746
                    goto out;
4180 decky 747
                }
748
 
1888 jermar 749
                counter += retval;
4199 svoboda 750
                j = nxt;
1888 jermar 751
                goto next_char;
752
            case 'c':
4180 decky 753
                if (qualifier == PrintfQualifierLong)
754
                    retval = print_wchar(va_arg(ap, wchar_t), width, flags, ps);
755
                else
756
                    retval = print_char(va_arg(ap, unsigned int), width, flags, ps);
757
 
2572 jermar 758
                if (retval < 0) {
1888 jermar 759
                    counter = -counter;
760
                    goto out;
761
                };
4180 decky 762
 
1888 jermar 763
                counter += retval;
4199 svoboda 764
                j = nxt;
1888 jermar 765
                goto next_char;
4180 decky 766
 
767
            /*
1888 jermar 768
             * Integer values
769
             */
4180 decky 770
            case 'P':
771
                /* Pointer */
3058 decky 772
                flags |= __PRINTF_FLAG_BIGCHARS;
1888 jermar 773
            case 'p':
774
                flags |= __PRINTF_FLAG_PREFIX;
775
                base = 16;
776
                qualifier = PrintfQualifierPointer;
4180 decky 777
                break;
778
            case 'b':
1888 jermar 779
                base = 2;
780
                break;
781
            case 'o':
782
                base = 8;
783
                break;
784
            case 'd':
785
            case 'i':
4180 decky 786
                flags |= __PRINTF_FLAG_SIGNED;
1888 jermar 787
            case 'u':
788
                break;
789
            case 'X':
790
                flags |= __PRINTF_FLAG_BIGCHARS;
791
            case 'x':
792
                base = 16;
793
                break;
4180 decky 794
 
795
            /* Percentile itself */
796
            case '%':
1888 jermar 797
                j = i;
798
                goto next_char;
4180 decky 799
 
1888 jermar 800
            /*
801
             * Bad formatting.
802
             */
803
            default:
2572 jermar 804
                /*
805
                 * Unknown format. Now, j is the index of '%'
806
                 * so we will print whole bad format sequence.
1888 jermar 807
                 */
4180 decky 808
                goto next_char;
1271 cejka 809
            }
4180 decky 810
 
811
            /* Print integers */
812
            size_t size;
813
            uint64_t number;
1271 cejka 814
            switch (qualifier) {
1888 jermar 815
            case PrintfQualifierByte:
816
                size = sizeof(unsigned char);
3058 decky 817
                number = (uint64_t) va_arg(ap, unsigned int);
1888 jermar 818
                break;
819
            case PrintfQualifierShort:
820
                size = sizeof(unsigned short);
3058 decky 821
                number = (uint64_t) va_arg(ap, unsigned int);
1888 jermar 822
                break;
823
            case PrintfQualifierInt:
824
                size = sizeof(unsigned int);
3058 decky 825
                number = (uint64_t) va_arg(ap, unsigned int);
1888 jermar 826
                break;
827
            case PrintfQualifierLong:
828
                size = sizeof(unsigned long);
3058 decky 829
                number = (uint64_t) va_arg(ap, unsigned long);
1888 jermar 830
                break;
831
            case PrintfQualifierLongLong:
832
                size = sizeof(unsigned long long);
3058 decky 833
                number = (uint64_t) va_arg(ap, unsigned long long);
1888 jermar 834
                break;
835
            case PrintfQualifierPointer:
836
                size = sizeof(void *);
3058 decky 837
                number = (uint64_t) (unsigned long) va_arg(ap, void *);
1888 jermar 838
                break;
4180 decky 839
            default:
840
                /* Unknown qualifier */
1888 jermar 841
                counter = -counter;
842
                goto out;
1271 cejka 843
            }
844
 
845
            if (flags & __PRINTF_FLAG_SIGNED) {
2572 jermar 846
                if (number & (0x1 << (size * 8 - 1))) {
1271 cejka 847
                    flags |= __PRINTF_FLAG_NEGATIVE;
4180 decky 848
 
1780 jermar 849
                    if (size == sizeof(uint64_t)) {
3058 decky 850
                        number = -((int64_t) number);
1271 cejka 851
                    } else {
852
                        number = ~number;
2572 jermar 853
                        number &=
854
                            ~(0xFFFFFFFFFFFFFFFFll <<
855
                            (size * 8));
1271 cejka 856
                        number++;
857
                    }
858
                }
859
            }
4180 decky 860
 
2572 jermar 861
            if ((retval = print_number(number, width, precision,
862
                base, flags, ps)) < 0) {
1271 cejka 863
                counter = -counter;
864
                goto out;
2572 jermar 865
            }
4180 decky 866
 
1271 cejka 867
            counter += retval;
4199 svoboda 868
            j = nxt;
4180 decky 869
        }
1271 cejka 870
next_char:
4199 svoboda 871
        ;
1271 cejka 872
    }
873
 
874
    if (i > j) {
4180 decky 875
        if ((retval = printf_putnchars_utf8(&fmt[j], i - j, ps)) < 0) {
876
            /* Error */
1271 cejka 877
            counter = -counter;
878
            goto out;
879
        }
880
        counter += retval;
881
    }
4180 decky 882
 
1271 cejka 883
out:
4180 decky 884
    return ((int) counter);
1271 cejka 885
}
886
 
1888 jermar 887
/** @}
1702 cejka 888
 */