annotate lib/xprintf.c @ 40057:b06060465f09

maint: Run 'make update-copyright'
author Paul Eggert <eggert@cs.ucla.edu>
date Tue, 01 Jan 2019 00:25:11 +0100
parents 10eb9086bea0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
1 /* printf wrappers that fail immediately for non-file-related errors
40057
b06060465f09 maint: Run 'make update-copyright'
Paul Eggert <eggert@cs.ucla.edu>
parents: 19484
diff changeset
2 Copyright (C) 2007, 2009-2019 Free Software Foundation, Inc.
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
3
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
4 This program is free software: you can redistribute it and/or modify
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
5 it under the terms of the GNU General Public License as published by
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
6 the Free Software Foundation; either version 3 of the License, or
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
7 (at your option) any later version.
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
8
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
12 GNU General Public License for more details.
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
13
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
14 You should have received a copy of the GNU General Public License
19190
9759915b2aca all: prefer https: URLs
Paul Eggert <eggert@cs.ucla.edu>
parents: 18626
diff changeset
15 along with this program. If not, see <https://www.gnu.org/licenses/>. */
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
16
9374
f3d25691c7ac * lib/xprintf.c: Include <config.h> unconditionally.
Jim Meyering <meyering@redhat.com>
parents: 9372
diff changeset
17 #include <config.h>
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
18
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
19 #include "xprintf.h"
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
20
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
21 #include <errno.h>
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
22
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
23 #include "error.h"
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
24 #include "exitfail.h"
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
25 #include "gettext.h"
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
26
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
27 /* written by Jim Meyering */
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
28
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
29 /* Just like printf, but call error if it fails without setting the
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
30 stream's error indicator. */
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
31 int
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
32 xprintf (char const *restrict format, ...)
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
33 {
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
34 va_list args;
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
35 int retval;
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
36 va_start (args, format);
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
37 retval = xvprintf (format, args);
9398
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
38 va_end (args);
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
39
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
40 return retval;
9398
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
41 }
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
42
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
43 /* Just like vprintf, but call error if it fails without setting the
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
44 stream's error indicator. */
9398
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
45 int
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
46 xvprintf (char const *restrict format, va_list args)
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
47 {
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
48 int retval = vprintf (format, args);
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
49 if (retval < 0 && ! ferror (stdout))
9372
091bbc680bf8 xprintf fixes.
Jim Meyering <meyering@redhat.com>
parents: 9366
diff changeset
50 error (exit_failure, errno, gettext ("cannot perform formatted output"));
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
51
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
52 return retval;
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
53 }
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
54
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
55 /* Just like fprintf, but call error if it fails without setting the
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
56 stream's error indicator. */
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
57 int
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
58 xfprintf (FILE *restrict stream, char const *restrict format, ...)
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
59 {
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
60 va_list args;
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
61 int retval;
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
62 va_start (args, format);
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
63 retval = xvfprintf (stream, format, args);
9372
091bbc680bf8 xprintf fixes.
Jim Meyering <meyering@redhat.com>
parents: 9366
diff changeset
64 va_end (args);
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
65
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
66 return retval;
9364
559ef0e161fe New module: xprintf
Jim Meyering <meyering@redhat.com>
parents:
diff changeset
67 }
9398
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
68
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
69 /* Just like vfprintf, but call error if it fails without setting the
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
70 stream's error indicator. */
9398
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
71 int
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
72 xvfprintf (FILE *restrict stream, char const *restrict format, va_list args)
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
73 {
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
74 int retval = vfprintf (stream, format, args);
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
75 if (retval < 0 && ! ferror (stream))
9398
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
76 error (exit_failure, errno, gettext ("cannot perform formatted output"));
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
77
9401
8e698de353f7 Tweak x*printf documentation.
Eric Blake <ebb9@byu.net>
parents: 9398
diff changeset
78 return retval;
9398
9d8f7facb7a6 Also wrap vf?printf.
Eric Blake <ebb9@byu.net>
parents: 9374
diff changeset
79 }