chiark / gitweb /
transparent background for about disorder.. image
[disorder] / lib / asprintf.c
1 /*
2  * This file is part of DisOrder
3  * Copyright (C) 2004, 2006 Richard Kettlewell
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 2 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
18  * USA
19  */
20 /** @file lib/asprintf.c @brief printf() workalikes */
21
22 #include <config.h>
23 #include "types.h"
24
25 #include <stdio.h>
26 #include <string.h>
27 #include <stdarg.h>
28 #include <stddef.h>
29 #include <errno.h>
30
31 #include "printf.h"
32 #include "sink.h"
33 #include "mem.h"
34 #include "vector.h"
35 #include "log.h"
36
37 /** @brief vasprintf() workalike without encoding errors
38  *
39  * This acts like vasprintf() except that it does not throw an error
40  * if you use a string outside the current locale's encoding rules,
41  * and it uses the memory allocation calls from @ref mem.h.
42  */
43 int byte_vasprintf(char **ptrp,
44                    const char *fmt,
45                    va_list ap) {
46   struct dynstr d;
47   int n;
48
49   dynstr_init(&d);
50   if((n = byte_vsinkprintf(sink_dynstr(&d), fmt, ap)) >= 0) {
51     dynstr_terminate(&d);
52     *ptrp = d.vec;
53   }
54   return n;
55 }
56
57 /** @brief asprintf() workalike without encoding errors
58  *
59  * This acts like asprintf() except that it does not throw an error
60  * if you use a string outside the current locale's encoding rules,
61  * and it uses the memory allocation calls from @ref mem.h.
62  */
63 int byte_asprintf(char **ptrp,
64                   const char *fmt,
65                   ...) {
66   int n;
67   va_list ap;
68
69   va_start(ap, fmt);
70   n = byte_vasprintf(ptrp, fmt, ap);
71   va_end(ap);
72   return n;
73 }
74
75 /** @brief asprintf() workalike without encoding errors
76  *
77  * This acts like asprintf() except that it does not throw an error if
78  * you use a string outside the current locale's encoding rules; it
79  * uses the memory allocation calls from @ref mem.h; and it terminates
80  * the program on error.
81  */
82 int byte_xasprintf(char **ptrp,
83                    const char *fmt,
84                    ...) {
85   int n;
86   va_list ap;
87
88   va_start(ap, fmt);
89   n = byte_xvasprintf(ptrp, fmt, ap);
90   va_end(ap);
91   return n;
92 }
93
94 /** @brief vasprintf() workalike without encoding errors
95  *
96  * This acts like vasprintf() except that it does not throw an error
97  * if you use a string outside the current locale's encoding rules; it
98  * uses the memory allocation calls from @ref mem.h; and it terminates
99  * the program on error.
100  */
101 int byte_xvasprintf(char **ptrp,
102                     const char *fmt,
103                     va_list ap) {
104   int n;
105
106   if((n = byte_vasprintf(ptrp, fmt, ap)) < 0)
107     fatal(errno, "error calling byte_vasprintf");
108   return n;
109 }
110
111 /*
112 Local Variables:
113 c-basic-offset:2
114 comment-column:40
115 End:
116 */