source: soft/giet_vm/memo/include/libelfpp/dpp/fstring @ 589

Last change on this file since 589 was 163, checked in by karaoui, 13 years ago

changing mover to memo
changing soft.bin to soft.elf
...
File size: 10.0 KB
Line 
1/* -*- c++ -*-
2
3   Formatted string class
4
5   This file is part of the dpp library of C++ template classes
6
7   doc: http://diaxen.ssji.net/dpp/index.html
8   repo: https://www.ssji.net/svn/projets/trunk/libdpp
9
10   This program is free software: you can redistribute it and/or
11   modify it under the terms of the GNU Lesser General Public License
12   as published by the Free Software Foundation, either version 3 of
13   the License, or (at your option) any later version.
14
15   This program is distributed in the hope that it will be useful, but
16   WITHOUT ANY WARRANTY; without even the implied warranty of
17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18   Lesser General Public License for more details.
19
20   You should have received a copy of the GNU Lesser General Public
21   License along with this program.  If not, see
22   <http://www.gnu.org/licenses/>.
23
24   (c) 2008-2011 Alexandre Becoulet <alexandre.becoulet@free.fr>
25
26*/
27
28#ifndef DPP_FSTRING_HH_
29#define DPP_FSTRING_HH_
30
31#include <stdarg.h>
32#include <stdio.h>
33
34#include <string>
35
36/** @file @module{Formatted string} */
37
38#ifdef __GNUC__
39# define _DPP_FORMAT_CHK(archetype, string_index, first_to_check)
40#else
41# define _DPP_FORMAT_CHK(archetype, string_index, first_to_check) \
42  __attribute__((format(archetype, string_index, first_to_check)))
43#endif
44
45namespace dpp {
46
47  /**
48     @short Extended std::string with sprintf family of functions.
49     @module {Formatted string}
50     @header dpp/fstring
51     @main
52
53     This class provides an extension of the @ref std::string class
54     with @ref sprintf family of functions and constructors,
55     for those who find @ref std::ostringstream sometimes cumbersome
56     to use. Yes, I know, it's not type safe.
57
58     Allocation is performed by underlying @ref std::string class and
59     format string are processed using the @ref ::vsnprintf libc function
60     with proper buffer size.
61   */
62  class fstring : public std::string
63  {
64  public:
65    /** @multiple @ref std::string standard constructor */
66    fstring()
67      : std::string()
68    {
69    }
70
71    explicit fstring(const std::string &str)
72      : std::string(str)
73    {
74    }
75
76    /** @This creates a @ref fstring object from char array. Unlike
77        the @insert {__fstring2__} prototype constructor, @this does
78        not perform formatting; initialization with buffer containing
79        conversion specifiers is safe to use. */
80    fstring(const char *str)
81      : std::string(str)
82    {
83    }
84
85#ifdef __MKDOC__
86    /** @This creates a @ref fstring object from format string and
87        associated arguments. Up to 16 extra arguments can be passed.
88        @alias fstring2
89    */
90    fstring(const char *str, ...);
91
92#else // mkdoc:skip
93
94#define _DPP_FSTRING_CSTR(b, c, ...)                                    \
95    _DPP_FORMAT_CHK(printf, 1, 2)                                       \
96    template <__VA_ARGS__>                                              \
97    fstring b                                                           \
98    {                                                                   \
99      dpp::fstring::sprintf c;                                          \
100    }
101
102    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0),
103       (fmt, a0),
104       typename A0)
105    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1),
106       (fmt, a0, a1),
107       typename A0, typename A1)
108    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2),
109       (fmt, a0, a1, a2),
110       typename A0, typename A1, typename A2)
111    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3),
112       (fmt, a0, a1, a2, a3),
113       typename A0, typename A1, typename A2, typename A3)
114    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4),
115       (fmt, a0, a1, a2, a3, a4),
116       typename A0, typename A1, typename A2, typename A3, typename A4)
117    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5),
118       (fmt, a0, a1, a2, a3, a4, a5),
119       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5)
120    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6),
121       (fmt, a0, a1, a2, a3, a4, a5, a6),
122       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6)
123    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7),
124       (fmt, a0, a1, a2, a3, a4, a5, a6, a7),
125       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7)
126    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7, const A8 &a8),
127       (fmt, a0, a1, a2, a3, a4, a5, a6, a7, a8),
128       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7, typename A8)
129    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7, const A8 &a8, const A9 &a9),
130       (fmt, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9),
131       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7, typename A8, typename A9)
132    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7, const A8 &a8, const A9 &a9, const A10 &a10),
133       (fmt, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10),
134       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7, typename A8, typename A9, typename A10)
135    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7, const A8 &a8, const A9 &a9, const A10 &a10, const A11 &a11),
136       (fmt, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11),
137       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7, typename A8, typename A9, typename A10, typename A11)
138    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7, const A8 &a8, const A9 &a9, const A10 &a10, const A11 &a11, const A12 &a12),
139       (fmt, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12),
140       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7, typename A8, typename A9, typename A10, typename A11, typename A12)
141    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7, const A8 &a8, const A9 &a9, const A10 &a10, const A11 &a11, const A12 &a12, const A13 &a13),
142       (fmt, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13),
143       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7, typename A8, typename A9, typename A10, typename A11, typename A12, typename A13)
144    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7, const A8 &a8, const A9 &a9, const A10 &a10, const A11 &a11, const A12 &a12, const A13 &a13, const A14 &a14),
145       (fmt, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14),
146       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7, typename A8, typename A9, typename A10, typename A11, typename A12, typename A13, typename A14)
147    _DPP_FSTRING_CSTR((const char *fmt, const A0 &a0, const A1 &a1, const A2 &a2, const A3 &a3, const A4 &a4, const A5 &a5, const A6 &a6, const A7 &a7, const A8 &a8, const A9 &a9, const A10 &a10, const A11 &a11, const A12 &a12, const A13 &a13, const A14 &a14, const A15 &a15),
148       (fmt, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15),
149       typename A0, typename A1, typename A2, typename A3, typename A4, typename A5, typename A6, typename A7, typename A8, typename A9, typename A10, typename A11, typename A12, typename A13, typename A14, typename A15)
150#endif
151
152    /** @This preallocates a string of given size and creates a @ref
153        fstring from format string and associated arguments. */
154    _DPP_FORMAT_CHK(printf, 1, 3)
155    fstring(size_t size, const char *fmt, ...)
156    {
157      va_list ap;
158      va_start(ap, fmt);
159      dpp::fstring::vsnprintf(size, fmt, ap);
160      va_end(ap);
161    }
162
163    /** @This overwrites current content using format string and
164        associated arguments. */
165    int vsprintf(const char *fmt, va_list ap)
166    {
167      int s;
168      va_list aq;
169
170      va_copy(aq, ap);
171      if (empty())
172        s = ::vsnprintf(NULL, 0, fmt, aq);
173      else
174        s = ::vsnprintf(&at(0), size() + 1, fmt, aq);
175
176      if (s >= 0 && s > (int)size())
177        {
178          resize(s);
179          s = ::vsnprintf(&at(0), size() + 1, fmt, ap);
180        }
181
182      va_end(aq);
183      return s;
184    }
185
186    /** @This resizes current buffer and overwrite its content
187        using format string and associated arguments. */
188    int vsnprintf(size_t size, const char *fmt, va_list ap)
189    {
190      resize(size);
191      return ::vsnprintf(&at(0), size + 1, fmt, ap);
192    }
193
194    /** @This overwrites current content using format string and
195        associated arguments. */
196    _DPP_FORMAT_CHK(printf, 1, 2)
197    int sprintf(const char *fmt, ...)
198    {
199      va_list ap;
200      int res;
201      va_start(ap, fmt);
202      res = dpp::fstring::vsprintf(fmt, ap);
203      va_end(ap);
204      return res;
205    }
206
207    /** @This resizes current buffer and overwrite its content
208        using format string and associated arguments. */
209    _DPP_FORMAT_CHK(printf, 1, 3)
210    int snprintf(size_t size, const char *fmt, ...)
211    {
212      va_list ap;
213      int res;
214      va_start(ap, fmt);
215      res = dpp::fstring::vsnprintf(size, fmt, ap);
216      va_end(ap);
217      return res;
218    }
219
220    /** @This returns the buffer content as a @tt{const char *}. @see c_str */
221    operator const char *() {
222      return c_str();
223    }
224
225    /** @This returns the buffer content as a @tt{const char *}. @see c_str */
226    const char * operator+() {
227      return c_str();
228    }
229
230  };
231
232}
233
234#endif
235
Note: See TracBrowser for help on using the repository browser.