u_printf.h revision 68e1a643 
1//
2// Copyright 2020 Serge Martin
3//
4// Permission is hereby granted, free of charge, to any person obtaining a
5// copy of this software and associated documentation files (the "Software"),
6// to deal in the Software without restriction, including without limitation
7// the rights to use, copy, modify, merge, publish, distribute, sublicense,
8// and/or sell copies of the Software, and to permit persons to whom the
9// Software is furnished to do so, subject to the following conditions:
10//
11// The above copyright notice and this permission notice shall be included in
12// all copies or substantial portions of the Software.
13//
14// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
18// OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20// OTHER DEALINGS IN THE SOFTWARE.
21//
22#ifndef U_PRINTF_H
23#define U_PRINTF_H
24
25#ifdef __cplusplus
26
27#include <string>
28#include <cstdarg>
29
30/* find next valid printf specifier in a C++ std::string */
31size_t util_printf_next_spec_pos(const std::string &s, size_t pos);
32
33extern "C" {
34#endif
35
36/* find next valid printf specifier in a C string wrapper */
37size_t util_printf_next_spec_pos(const char *str, size_t pos);
38
39/* Return the length of the string that would be generated by a printf-style
40 * format and argument list, not including the \0 byte.
41 * The untouched_args parameter is left untouched so it can be re-used by the
42 * caller in a vsnprintf() call or similar.
43 */
44size_t u_printf_length(const char *fmt, va_list untouched_args);
45
46#ifdef __cplusplus
47}
48#endif
49
50#endif
51