mpd/src/util/FormatString.hxx

// SPDX-License-Identifier: GPL-2.0-or-later
// Copyright The Music Player Daemon Project

#ifndef MPD_FORMAT_STRING_HXX
#define MPD_FORMAT_STRING_HXX

#include "Compiler.h"

#include <cstdarg>

class AllocatedString;

/**
 * Format into an #AllocatedString.
 */
[[gnu::nonnull]]
AllocatedString
FormatStringV(const char *fmt, std::va_list args) noexcept;

/**
 * Format into an #AllocatedString.
 */
[[gnu::nonnull(1)]]
gcc_printf(1,2)
AllocatedString
FormatString(const char *fmt, ...) noexcept;

#endif
use SPDX IDs, replacing the long copyright headers 2023-03-06 14:42:04 +01:00			`// SPDX-License-Identifier: GPL-2.0-or-later`
			`// Copyright The Music Player Daemon Project`
util/FormatString: new library to replace g_strdup_printf() 2013-10-19 16:58:45 +02:00
			`#ifndef MPD_FORMAT_STRING_HXX`
			`#define MPD_FORMAT_STRING_HXX`

			`#include "Compiler.h"`

replace stdarg.h with cstdarg The former was deprecated in C++14. The Standard says they are the same: The contents of the header<cstdarg>are the same as the C standard library header<stdarg.h>, with the following changes: The restrictions that ISO C places on the second parameter to the va_start macro in header<stdarg.h> are different in this International Standard. The parameter parmN is the rightmost parameter in the variable parameter list of the function definition (the one just before the...).219If the parameter parmN is a pack expansion (17.5.3) or an entity resulting from a lambda capture (8.1.5), the program is ill-formed, no diagnostic required. If the parameter parmN is of a reference type, or of a type that is not compatible with the type that results when passing an argument for which there is no parameter, the behavior is undefined. Also changed va_list to the std:: namespace version, which is the same. Signed-off-by: Rosen Penev <rosenp@gmail.com> 2020-03-13 00:31:17 +01:00			`#include <cstdarg>`
util/FormatString: new library to replace g_strdup_printf() 2013-10-19 16:58:45 +02:00
util/AllocatedString: rename to BasicAllocatedString To make things simpler, AllocatedString is now a non-template class. 2021-01-14 12:39:45 +01:00			`class AllocatedString;`
util/FormatString: return AllocatedString 2016-04-12 22:27:15 +02:00
util/FormatString: new library to replace g_strdup_printf() 2013-10-19 16:58:45 +02:00			`/**`
util/FormatString: update API documentation 2020-10-28 15:48:23 +01:00			`* Format into an #AllocatedString.`
util/FormatString: new library to replace g_strdup_printf() 2013-10-19 16:58:45 +02:00			`*/`
util/PeakBuffer, ...: use [[gnu::]] attributes 2022-04-26 20:19:31 +02:00			`[[gnu::nonnull]]`
util/AllocatedString: rename to BasicAllocatedString To make things simpler, AllocatedString is now a non-template class. 2021-01-14 12:39:45 +01:00			`AllocatedString`
replace stdarg.h with cstdarg The former was deprecated in C++14. The Standard says they are the same: The contents of the header<cstdarg>are the same as the C standard library header<stdarg.h>, with the following changes: The restrictions that ISO C places on the second parameter to the va_start macro in header<stdarg.h> are different in this International Standard. The parameter parmN is the rightmost parameter in the variable parameter list of the function definition (the one just before the...).219If the parameter parmN is a pack expansion (17.5.3) or an entity resulting from a lambda capture (8.1.5), the program is ill-formed, no diagnostic required. If the parameter parmN is of a reference type, or of a type that is not compatible with the type that results when passing an argument for which there is no parameter, the behavior is undefined. Also changed va_list to the std:: namespace version, which is the same. Signed-off-by: Rosen Penev <rosenp@gmail.com> 2020-03-13 00:31:17 +01:00			`FormatStringV(const char *fmt, std::va_list args) noexcept;`
util/FormatString: new library to replace g_strdup_printf() 2013-10-19 16:58:45 +02:00
			`/**`
util/FormatString: update API documentation 2020-10-28 15:48:23 +01:00			`* Format into an #AllocatedString.`
util/FormatString: new library to replace g_strdup_printf() 2013-10-19 16:58:45 +02:00			`*/`
util/PeakBuffer, ...: use [[gnu::]] attributes 2022-04-26 20:19:31 +02:00			`[[gnu::nonnull(1)]]`
			`gcc_printf(1,2)`
util/AllocatedString: rename to BasicAllocatedString To make things simpler, AllocatedString is now a non-template class. 2021-01-14 12:39:45 +01:00			`AllocatedString`
util/FormatString: add "noexcept" 2017-05-16 10:22:52 +02:00			`FormatString(const char *fmt, ...) noexcept;`
util/FormatString: new library to replace g_strdup_printf() 2013-10-19 16:58:45 +02:00
			`#endif`