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     #else
44         #define LV_PRId32 "d"
45         #define LV_PRIu32 "u"
46     #endif
47 #else
48     /* hope this is correct for ports without __has_include or without inttypes.h */
49     #define LV_PRId32 "d"
50     #define LV_PRIu32 "u"
51 #endif
52 
53 #ifdef __cplusplus
54 extern "C" {
55 #endif
56 
57 #include "../lv_conf_internal.h"
58 
59 #if LV_SPRINTF_CUSTOM == 0
60 
61 #include <stdarg.h>
62 #include <stddef.h>
63 
64 #include "lv_types.h"
65 
66 typedef struct {
67     const char * fmt;
68     va_list * va;
69 } lv_vaformat_t;
70 
71 /**
72  * Tiny snprintf/vsnprintf implementation
73  * \param buffer A pointer to the buffer where to store the formatted string
74  * \param count The maximum number of characters to store in the buffer, including a terminating null character
75  * \param format A string that specifies the format of the output
76  * \param va A value identifying a variable arguments list
77  * \return The number of characters that COULD have been written into the buffer, not counting the terminating
78  *         null character. A value equal or larger than count indicates truncation. Only when the returned value
79  *         is non-negative and less than count, the string has been completely written.
80  */
81 int  lv_snprintf(char * buffer, size_t count, const char * format, ...) LV_FORMAT_ATTRIBUTE(3, 4);
82 int lv_vsnprintf(char * buffer, size_t count, const char * format, va_list va) LV_FORMAT_ATTRIBUTE(3, 0);
83 
84 #else
85 #include LV_SPRINTF_INCLUDE
86 #endif
87 
88 #ifdef __cplusplus
89 } /*extern "C"*/
90 #endif
91 
92 #endif  // _LV_PRINTF_H_
93