Subversion Repositories HelenOS-historic

Rev

Rev 1623 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
1234 cejka 1
/*
2
 * Copyright (C) 2006 Josef Cejka
3
 * All rights reserved.
4
 *
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
7
 * are met:
8
 *
9
 * - Redistributions of source code must retain the above copyright
10
 *   notice, this list of conditions and the following disclaimer.
11
 * - Redistributions in binary form must reproduce the above copyright
12
 *   notice, this list of conditions and the following disclaimer in the
13
 *   documentation and/or other materials provided with the distribution.
14
 * - The name of the author may not be used to endorse or promote products
15
 *   derived from this software without specific prior written permission.
16
 *
17
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27
 */
28
 
1653 cejka 29
 /** @addtogroup libc
30
 * @{
31
 */
32
/** @file
33
 */
34
 
1234 cejka 35
#include <stdarg.h>
36
#include <stdio.h>
37
#include <string.h>
38
#include <io/printf_core.h>
39
 
40
 
41
struct vsnprintf_data {
42
    size_t size; /* total space for string */
43
    size_t len; /* count of currently used characters */
44
    char *string; /* destination string */
45
};
46
 
47
int vsnprintf_write(const char *str, size_t count, struct vsnprintf_data *data);
48
 
49
/** Write string to given buffer.
50
 * Write at most data->size characters including trailing zero. According to C99 has snprintf to return number
51
 * of characters that would have been written if enough space had been available. Hence the return value is not
52
 * number of really printed characters but size of input string. Number of really used characters
53
 * is stored in data->len.
54
 * @param str source string to print
55
 * @param count size of source string
56
 * @param data structure with destination string, counter of used space and total string size.
57
 * @return number of characters to print (not characters really printed!)
58
 */
59
int vsnprintf_write(const char *str, size_t count, struct vsnprintf_data *data)
60
{
1617 cejka 61
    size_t i;
1234 cejka 62
    i = data->size - data->len;
63
 
1617 cejka 64
    if (i == 0) {
65
        return count;
1234 cejka 66
    }
67
 
1617 cejka 68
    if (i == 1) {
69
        /* We have only one free byte left in buffer => write there trailing zero */
70
        data->string[data->size - 1] = 0;
71
        data->len = data->size;
72
        return count;
73
    }
74
 
75
    if (i <= count) {
76
        /* We have not enought space for whole string with the trailing zero => print only a part of string */
77
            memcpy((void *)(data->string + data->len), (void *)str, i - 1);
78
            data->string[data->size - 1] = 0;
79
            data->len = data->size;
80
            return count;
81
    }
82
 
83
    /* Buffer is big enought to print whole string */
84
    memcpy((void *)(data->string + data->len), (void *)str, count);
85
    data->len += count;
86
    /* Put trailing zero at end, but not count it into data->len so it could be rewritten next time */
87
    data->string[data->len] = 0;
88
 
1234 cejka 89
    return count;  
90
}
91
 
1623 cejka 92
/** Print formatted to the given buffer with limited size.
93
 * @param str   buffer
94
 * @param size  buffer size
95
 * @param fmt   format string
96
 * \see For more details about format string see printf_core.
97
 */
1234 cejka 98
int vsnprintf(char *str, size_t size, const char *fmt, va_list ap)
99
{
100
    struct vsnprintf_data data = {size, 0, str};
101
    struct printf_spec ps = {(int(*)(void *, size_t, void *))vsnprintf_write, &data};
102
 
103
    /* Print 0 at end of string - fix the case that nothing will be printed */
104
    if (size > 0)
105
        str[0] = 0;
106
 
107
    /* vsnprintf_write ensures that str will be terminated by zero. */
108
    return printf_core(fmt, &ps, ap);
109
}
110
 
111
 
1653 cejka 112
 
113
 
114
 /** @}
115
 */
116
 
117