1 /* vasprintf and asprintf, with out-of-memory checking, in C locale. 2 Copyright (C) 2002-2004, 2006-2020 Free Software Foundation, Inc. 3 4 This program is free software: you can redistribute it and/or modify 5 it under the terms of the GNU General Public License as published by 6 the Free Software Foundation; either version 3 of the License, or 7 (at your option) any later version. 8 9 This program is distributed in the hope that it will be useful, 10 but WITHOUT ANY WARRANTY; without even the implied warranty of 11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 GNU General Public License for more details. 13 14 You should have received a copy of the GNU General Public License 15 along with this program. If not, see <https://www.gnu.org/licenses/>. */ 16 17 #ifndef _C_XVASPRINTF_H 18 #define _C_XVASPRINTF_H 19 20 /* Get va_list. */ 21 #include <stdarg.h> 22 23 #ifdef __cplusplus 24 extern "C" { 25 #endif 26 27 /* Write formatted output to a string dynamically allocated with malloc(), 28 and return it. Upon [ENOMEM] memory allocation error, call xalloc_die. 29 On some other error 30 - [EOVERFLOW] resulting string length is > INT_MAX, 31 - [EINVAL] invalid format string, 32 - [EILSEQ] error during conversion between wide and multibyte characters, 33 return NULL. 34 35 Formatting takes place in the C locale, that is, the decimal point 36 used in floating-point formatting directives is always '.'. */ 37 extern char *c_xasprintf (const char *format, ...) 38 _GL_ATTRIBUTE_FORMAT ((__printf__, 1, 2)); 39 extern char *c_xvasprintf (const char *format, va_list args) 40 _GL_ATTRIBUTE_FORMAT ((__printf__, 1, 0)); 41 42 #ifdef __cplusplus 43 } 44 #endif 45 46 #endif /* _C_XVASPRINTF_H */ 47