1 ///////////////////////////////////////////////////////////////////////////////
2 // \author (c) Marco Paland (info@paland.com)
3 //             2014-2019, PALANDesign Hannover, Germany
4 //
5 // \license The MIT License (MIT)
6 //
7 // Permission is hereby granted, free of charge, to any person obtaining a copy
8 // of this software and associated documentation files (the "Software"), to deal
9 // in the Software without restriction, including without limitation the rights
10 // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 // copies of the Software, and to permit persons to whom the Software is
12 // furnished to do so, subject to the following conditions:
13 //
14 // The above copyright notice and this permission notice shall be included in
15 // all copies or substantial portions of the Software.
16 //
17 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23 // THE SOFTWARE.
24 //
25 // \brief Tiny printf, sprintf and snprintf implementation, optimized for speed on
26 //        embedded systems with a very limited resources.
27 //        Use this instead of bloated standard/newlib printf.
28 //        These routines are thread safe and reentrant.
29 //
30 ///////////////////////////////////////////////////////////////////////////////
31 
32 /*Original repository: https://github.com/mpaland/printf*/
33 
34 #ifndef _LV_PRINTF_H_
35 #define _LV_PRINTF_H_
36 
37 #if defined(__has_include)
38     #if __has_include(<inttypes.h>)
39         #include <inttypes.h>
40         /* platform-specific printf format for int32_t, usually "d" or "ld" */
41         #define LV_PRId32 PRId32
42         #define LV_PRIu32 PRIu32
43         #define LV_PRIx32 PRIx32
44         #define LV_PRIX32 PRIX32
45     #else
46         #define LV_PRId32 "d"
47         #define LV_PRIu32 "u"
48         #define LV_PRIx32 "x"
49         #define LV_PRIX32 "X"
50     #endif
51 #else
52     /* hope this is correct for ports without __has_include or without inttypes.h */
53     #define LV_PRId32 "d"
54     #define LV_PRIu32 "u"
55     #define LV_PRIx32 "x"
56     #define LV_PRIX32 "X"
57 #endif
58 
59 #ifdef __cplusplus
60 extern "C" {
61 #endif
62 
63 #include "../lv_conf_internal.h"
64 
65 #if LV_SPRINTF_CUSTOM == 0
66 
67 #include <stdarg.h>
68 #include <stddef.h>
69 
70 #include "lv_types.h"
71 
72 typedef struct {
73     const char * fmt;
74     va_list * va;
75 } lv_vaformat_t;
76 
77 /**
78  * Tiny snprintf/vsnprintf implementation
79  * \param buffer A pointer to the buffer where to store the formatted string
80  * \param count The maximum number of characters to store in the buffer, including a terminating null character
81  * \param format A string that specifies the format of the output
82  * \param va A value identifying a variable arguments list
83  * \return The number of characters that COULD have been written into the buffer, not counting the terminating
84  *         null character. A value equal or larger than count indicates truncation. Only when the returned value
85  *         is non-negative and less than count, the string has been completely written.
86  */
87 int  lv_snprintf(char * buffer, size_t count, const char * format, ...) LV_FORMAT_ATTRIBUTE(3, 4);
88 int lv_vsnprintf(char * buffer, size_t count, const char * format, va_list va) LV_FORMAT_ATTRIBUTE(3, 0);
89 
90 #else
91 #include LV_SPRINTF_INCLUDE
92 #endif
93 
94 #ifdef __cplusplus
95 } /*extern "C"*/
96 #endif
97 
98 #endif  // _LV_PRINTF_H_
99