u_printf.h revision 7ec681f3 
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
29/* find next valid printf specifier in a C++ std::string */
30size_t util_printf_next_spec_pos(const std::string &s, size_t pos);
31
32extern "C" {
33#endif
34
35/* find next valid printf specifier in a C string wrapper */
36size_t util_printf_next_spec_pos(const char *str, size_t pos);
37
38/* Return the length of the string that would be generated by a printf-style
39 * format and argument list, not including the \0 byte.
40 * The untouched_args parameter is left untouched so it can be re-used by the
41 * caller in a vsnprintf() call or similar.
42 */
43size_t u_printf_length(const char *fmt, va_list untouched_args);
44
45#ifdef __cplusplus
46}
47#endif
48
49#endif
50