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 #ifndef _LV_PRINTF_H_
33 #define _LV_PRINTF_H_
34 
35 
36 #ifdef __cplusplus
37 extern "C" {
38 #endif
39 
40 #include "../lv_conf_internal.h"
41 
42 #if LV_SPRINTF_CUSTOM == 0
43 
44 #include <stdarg.h>
45 #include <stddef.h>
46 
47 /**
48  * Tiny snprintf/vsnprintf implementation
49  * \param buffer A pointer to the buffer where to store the formatted string
50  * \param count The maximum number of characters to store in the buffer, including a terminating null character
51  * \param format A string that specifies the format of the output
52  * \param va A value identifying a variable arguments list
53  * \return The number of characters that COULD have been written into the buffer, not counting the terminating
54  *         null character. A value equal or larger than count indicates truncation. Only when the returned value
55  *         is non-negative and less than count, the string has been completely written.
56  */
57 int  lv_snprintf(char * buffer, size_t count, const char * format, ...);
58 int lv_vsnprintf(char * buffer, size_t count, const char * format, va_list va);
59 
60 #else
61 #include LV_SPRINTF_INCLUDE
62 #endif
63 
64 
65 #ifdef __cplusplus
66 }
67 #endif
68 
69 
70 #endif  // _PRINTF_H_
71