OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef BASE_STRINGPRINTF_H_ | 5 #ifndef BASE_STRINGPRINTF_H_ |
6 #define BASE_STRINGPRINTF_H_ | 6 #define BASE_STRINGPRINTF_H_ |
7 | 7 |
8 #include <stdarg.h> // va_list | 8 #include <stdarg.h> // va_list |
9 | 9 |
10 #include <string> | 10 #include <string> |
11 | 11 |
12 #include "base/base_export.h" | 12 #include "base/base_export.h" |
13 #include "base/compiler_specific.h" | 13 #include "base/compiler_specific.h" |
14 | 14 |
15 namespace base { | 15 namespace base { |
16 | 16 |
17 // Return a C++ string given printf-like input. | 17 // Return a C++ string given printf-like input. |
18 BASE_EXPORT std::string StringPrintf(const char* format, ...) | 18 BASE_EXPORT std::string StringPrintf(const char* format, ...) |
19 PRINTF_FORMAT(1, 2); | 19 PRINTF_FORMAT(1, 2); |
20 BASE_EXPORT std::wstring StringPrintf(const wchar_t* format, ...) | |
21 WPRINTF_FORMAT(1, 2); | |
22 | 20 |
23 // Return a C++ string given vprintf-like input. | 21 // Return a C++ string given vprintf-like input. |
24 BASE_EXPORT std::string StringPrintV(const char* format, va_list ap) | 22 BASE_EXPORT std::string StringPrintV(const char* format, va_list ap) |
25 PRINTF_FORMAT(1, 0); | 23 PRINTF_FORMAT(1, 0); |
26 | 24 |
27 // Store result into a supplied string and return it. | 25 // Store result into a supplied string and return it. |
28 BASE_EXPORT const std::string& SStringPrintf(std::string* dst, | 26 BASE_EXPORT const std::string& SStringPrintf(std::string* dst, |
29 const char* format, ...) | 27 const char* format, ...) |
30 PRINTF_FORMAT(2, 3); | 28 PRINTF_FORMAT(2, 3); |
31 BASE_EXPORT const std::wstring& SStringPrintf(std::wstring* dst, | |
32 const wchar_t* format, ...) | |
33 WPRINTF_FORMAT(2, 3); | |
34 | 29 |
35 // Append result to a supplied string. | 30 // Append result to a supplied string. |
36 BASE_EXPORT void StringAppendF(std::string* dst, const char* format, ...) | 31 BASE_EXPORT void StringAppendF(std::string* dst, const char* format, ...) |
37 PRINTF_FORMAT(2, 3); | 32 PRINTF_FORMAT(2, 3); |
38 // TODO(evanm): this is only used in a few places in the code; | |
39 // replace with string16 version. | |
40 BASE_EXPORT void StringAppendF(std::wstring* dst, const wchar_t* format, ...) | |
41 WPRINTF_FORMAT(2, 3); | |
42 | 33 |
43 // Lower-level routine that takes a va_list and appends to a specified | 34 // Lower-level routine that takes a va_list and appends to a specified |
44 // string. All other routines are just convenience wrappers around it. | 35 // string. All other routines are just convenience wrappers around it. |
45 BASE_EXPORT void StringAppendV(std::string* dst, const char* format, va_list ap) | 36 BASE_EXPORT void StringAppendV(std::string* dst, const char* format, va_list ap) |
46 PRINTF_FORMAT(2, 0); | 37 PRINTF_FORMAT(2, 0); |
47 BASE_EXPORT void StringAppendV(std::wstring* dst, | |
48 const wchar_t* format, va_list ap) | |
49 WPRINTF_FORMAT(2, 0); | |
50 | 38 |
51 } // namespace base | 39 } // namespace base |
52 | 40 |
53 // Don't require the namespace for legacy code. New code should use "base::" or | 41 // Don't require the namespace for legacy code. New code should use "base::" or |
54 // have its own using decl. | 42 // have its own using decl. |
55 // | 43 // |
56 // TODO(brettw) remove these when calling code is converted. | 44 // TODO(brettw) remove these when calling code is converted. |
57 using base::StringPrintf; | 45 using base::StringPrintf; |
58 | 46 |
59 #endif // BASE_STRINGPRINTF_H_ | 47 #endif // BASE_STRINGPRINTF_H_ |
OLD | NEW |