libexplain  1.4.D001
libexplain/snprintf.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_SNPRINTF_H
00020 #define LIBEXPLAIN_SNPRINTF_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 
00068 int explain_snprintf_or_die(char *data, size_t data_size, const char *format,
00069     ...)
00070                                                  LIBEXPLAIN_FORMAT_PRINTF(3, 4);
00071 
00103 int explain_snprintf_on_error(char *data, size_t data_size, const char *format,
00104     ...)
00105                                                  LIBEXPLAIN_FORMAT_PRINTF(3, 4);
00106 
00153 const char *explain_snprintf(char *data, size_t data_size, const char *format,
00154     ...)
00155                                                   LIBEXPLAIN_FORMAT_PRINTF(3, 4)
00156                                                   LIBEXPLAIN_WARN_UNUSED_RESULT;
00157 
00209 const char *explain_errno_snprintf(int errnum, char *data, size_t data_size,
00210     const char *format, ...)
00211                                                   LIBEXPLAIN_FORMAT_PRINTF(4, 5)
00212                                                   LIBEXPLAIN_WARN_UNUSED_RESULT;
00213 
00259 void explain_message_snprintf(char *message, int message_size, char *data,
00260     size_t data_size, const char *format, ...)
00261                                                  LIBEXPLAIN_FORMAT_PRINTF(5, 6);
00262 
00312 void explain_message_errno_snprintf(char *message, int message_size, int errnum,
00313     char *data, size_t data_size, const char *format, ...)
00314                                                  LIBEXPLAIN_FORMAT_PRINTF(6, 7);
00315 
00316 #ifdef __cplusplus
00317 }
00318 #endif
00319 
00320 /* vim: set ts=8 sw=4 et : */
00321 #endif /* LIBEXPLAIN_SNPRINTF_H */