Fri, 07 Jul 2023 17:28:07 +0200
add iterator documentation
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
1 | /* |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
2 | * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
3 | * |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
4 | * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved. |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
5 | * |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
6 | * Redistribution and use in source and binary forms, with or without |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
7 | * modification, are permitted provided that the following conditions are met: |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
8 | * |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
9 | * 1. Redistributions of source code must retain the above copyright |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
10 | * notice, this list of conditions and the following disclaimer. |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
11 | * |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
12 | * 2. Redistributions in binary form must reproduce the above copyright |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
13 | * notice, this list of conditions and the following disclaimer in the |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
14 | * documentation and/or other materials provided with the distribution. |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
15 | * |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
16 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
17 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
18 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
19 | * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
20 | * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
21 | * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
22 | * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
23 | * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
24 | * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
25 | * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
26 | * POSSIBILITY OF SUCH DAMAGE. |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
27 | */ |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
28 | |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
29 | #include "cx/printf.h" |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
30 | |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
31 | #include <stdio.h> |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
32 | #include <string.h> |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
33 | |
643
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
34 | #ifndef CX_PRINTF_SBO_SIZE |
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
35 | #define CX_PRINTF_SBO_SIZE 512 |
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
36 | #endif |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
37 | |
643
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
38 | int cx_fprintf( |
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
39 | void *stream, |
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
40 | cx_write_func wfc, |
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
41 | char const *fmt, |
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
42 | ... |
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
43 | ) { |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
44 | int ret; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
45 | va_list ap; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
46 | va_start(ap, fmt); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
47 | ret = cx_vfprintf(stream, wfc, fmt, ap); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
48 | va_end(ap); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
49 | return ret; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
50 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
51 | |
644 | 52 | int cx_vfprintf( |
53 | void *stream, | |
54 | cx_write_func wfc, | |
55 | char const *fmt, | |
56 | va_list ap | |
57 | ) { | |
643
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
58 | char buf[CX_PRINTF_SBO_SIZE]; |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
59 | va_list ap2; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
60 | va_copy(ap2, ap); |
643
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
61 | int ret = vsnprintf(buf, CX_PRINTF_SBO_SIZE, fmt, ap); |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
62 | if (ret < 0) { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
63 | return ret; |
643
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
64 | } else if (ret < CX_PRINTF_SBO_SIZE) { |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
65 | return (int) wfc(buf, 1, ret, stream); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
66 | } else { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
67 | int len = ret + 1; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
68 | char *newbuf = malloc(len); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
69 | if (!newbuf) { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
70 | return -1; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
71 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
72 | |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
73 | ret = vsnprintf(newbuf, len, fmt, ap2); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
74 | if (ret > 0) { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
75 | ret = (int) wfc(newbuf, 1, ret, stream); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
76 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
77 | free(newbuf); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
78 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
79 | return ret; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
80 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
81 | |
644 | 82 | cxmutstr cx_asprintf_a( |
693
494d9b20b99e
fix missing const qualifier for allocator
Mike Becker <universe@uap-core.de>
parents:
644
diff
changeset
|
83 | CxAllocator const *allocator, |
644 | 84 | char const *fmt, |
85 | ... | |
86 | ) { | |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
87 | va_list ap; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
88 | cxmutstr ret; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
89 | va_start(ap, fmt); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
90 | ret = cx_vasprintf_a(allocator, fmt, ap); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
91 | va_end(ap); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
92 | return ret; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
93 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
94 | |
644 | 95 | cxmutstr cx_vasprintf_a( |
693
494d9b20b99e
fix missing const qualifier for allocator
Mike Becker <universe@uap-core.de>
parents:
644
diff
changeset
|
96 | CxAllocator const *a, |
644 | 97 | char const *fmt, |
98 | va_list ap | |
99 | ) { | |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
100 | cxmutstr s; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
101 | s.ptr = NULL; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
102 | s.length = 0; |
643
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
103 | char buf[CX_PRINTF_SBO_SIZE]; |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
104 | va_list ap2; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
105 | va_copy(ap2, ap); |
643
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
106 | int ret = vsnprintf(buf, CX_PRINTF_SBO_SIZE, fmt, ap); |
5700ba9154ab
#228 make buffer sizes adjustable at compile time
Mike Becker <universe@uap-core.de>
parents:
634
diff
changeset
|
107 | if (ret > 0 && ret < CX_PRINTF_SBO_SIZE) { |
599
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
108 | s.ptr = cxMalloc(a, ret + 1); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
109 | if (s.ptr) { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
110 | s.length = (size_t) ret; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
111 | memcpy(s.ptr, buf, ret); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
112 | s.ptr[s.length] = '\0'; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
113 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
114 | } else { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
115 | int len = ret + 1; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
116 | s.ptr = cxMalloc(a, len); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
117 | if (s.ptr) { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
118 | ret = vsnprintf(s.ptr, len, fmt, ap2); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
119 | if (ret < 0) { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
120 | free(s.ptr); |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
121 | s.ptr = NULL; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
122 | } else { |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
123 | s.length = (size_t) ret; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
124 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
125 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
126 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
127 | return s; |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
128 | } |
6536a9a75b71
#222 add printf-like functions
Mike Becker <universe@uap-core.de>
parents:
diff
changeset
|
129 |