1explain_iconv_close_or_die(3L)ibrary Functions Manuaelxplain_iconv_close_or_die(3)
2
3
4

NAME

6       explain_iconv_close_or_die   -  deallocate  conversion  descriptor  and
7       report errors
8

SYNOPSIS

10       #include <libexplain/iconv_close.h>
11       void explain_iconv_close_or_die(iconv_t cd);
12       int explain_iconv_close_on_error(iconv_t cd);
13

DESCRIPTION

15       The  explain_iconv_close_or_die  function   is   used   to   call   the
16       iconv_close(3)  system  call. On failure an explanation will be printed
17       to stderr, obtained from the explain_iconv_close(3) function, and  then
18       the process terminates by calling exit(EXIT_FAILURE).
19
20       The   explain_iconv_close_on_error   function   is  used  to  call  the
21       iconv_close(3) system call. On failure an explanation will  be  printed
22       to stderr, obtained from the explain_iconv_close(3) function, but still
23       returns to the caller.
24
25       cd      The cd, exactly as to be passed to  the  iconv_close(3)  system
26               call.
27

RETURN VALUE

29       The  explain_iconv_close_or_die  function  only returns on success, see
30       iconv_close(3) for more information. On failure, prints an  explanation
31       and exits, it does not return.
32
33       The  explain_iconv_close_on_error  function  always  returns  the value
34       return by the wrapped iconv_close(3) system call.
35

EXAMPLE

37       The explain_iconv_close_or_die function is intended to  be  used  in  a
38       fashion similar to the following example:
39              explain_iconv_close_or_die(cd);
40

SEE ALSO

42       iconv_close(3)
43               deallocate descriptor for character set conversion
44
45       explain_iconv_close(3)
46               explain iconv_close(3) errors
47
48       exit(2) terminate the calling process
49
51       libexplain version 1.4
52       Copyright (C) 2013 Peter Miller
53
54
55
56                                                 explain_iconv_close_or_die(3)
Impressum