libexplain  1.4.D001
libexplain/sprintf.h
Go to the documentation of this file.
00001 /*
00002  * libexplain - Explain errno values returned by libc functions
00003  * Copyright (C) 2010, 2013 Peter Miller
00004  *
00005  * This program is free software; you can redistribute it and/or modify it
00006  * under the terms of the GNU Lesser General Public License as published by
00007  * the Free Software Foundation; either version 3 of the License, or (at
00008  * your option) any later version.
00009  *
00010  * This program is distributed in the hope that it will be useful, but
00011  * WITHOUT ANY WARRANTY; without even the implied warranty of
00012  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
00013  * General Public License for more details.
00014  *
00015  * You should have received a copy of the GNU Lesser General Public License
00016  * along with this program. If not, see <http://www.gnu.org/licenses/>.
00017  */
00018 
00019 #ifndef LIBEXPLAIN_SPRINTF_H
00020 #define LIBEXPLAIN_SPRINTF_H
00021 
00030 #include <libexplain/gcc_attributes.h>
00031 #include <libexplain/large_file_support.h>
00032 #include <libexplain/gcc_attributes.h>
00033 
00034 #include <stdio.h>
00035 
00036 #ifdef __cplusplus
00037 extern "C" {
00038 #endif
00039 
00065 int explain_sprintf_or_die(char *data, const char *format, ...)
00066                                                  LIBEXPLAIN_FORMAT_PRINTF(2, 3);
00067 
00096 int explain_sprintf_on_error(char *data, const char *format, ...)
00097                                                  LIBEXPLAIN_FORMAT_PRINTF(2, 3);
00098 
00142 const char *explain_sprintf(char *data, const char *format, ...)
00143                                                   LIBEXPLAIN_FORMAT_PRINTF(2, 3)
00144                                                   LIBEXPLAIN_WARN_UNUSED_RESULT;
00145 
00193 const char *explain_errno_sprintf(int errnum, char *data, const char *format,
00194     ...)
00195                                                   LIBEXPLAIN_FORMAT_PRINTF(3, 4)
00196                                                   LIBEXPLAIN_WARN_UNUSED_RESULT;
00197 
00239 void explain_message_sprintf(char *message, int message_size, char *data,
00240     const char *format, ...)
00241                                                  LIBEXPLAIN_FORMAT_PRINTF(4, 5);
00242 
00289 void explain_message_errno_sprintf(char *message, int message_size, int errnum,
00290     char *data, const char *format, ...)
00291                                                  LIBEXPLAIN_FORMAT_PRINTF(5, 6);
00292 
00293 #ifdef __cplusplus
00294 }
00295 #endif
00296 
00297 /* vim: set ts=8 sw=4 et : */
00298 #endif /* LIBEXPLAIN_SPRINTF_H */