1 /* A GNU-like <iconv.h>.
2 
3    Copyright (C) 2007-2020 Free Software Foundation, Inc.
4 
5    This program is free software; you can redistribute it and/or modify
6    it under the terms of the GNU General Public License as published by
7    the Free Software Foundation; either version 3, or (at your option)
8    any later version.
9 
10    This program is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13    GNU General Public License for more details.
14 
15    You should have received a copy of the GNU General Public License
16    along with this program; if not, see <https://www.gnu.org/licenses/>.  */
17 
18 #ifndef _@GUARD_PREFIX@_ICONV_H
19 
20 #if __GNUC__ >= 3
21 @PRAGMA_SYSTEM_HEADER@
22 #endif
23 @PRAGMA_COLUMNS@
24 
25 /* The include_next requires a split double-inclusion guard.  */
26 #@INCLUDE_NEXT@ @NEXT_ICONV_H@
27 
28 #ifndef _@GUARD_PREFIX@_ICONV_H
29 #define _@GUARD_PREFIX@_ICONV_H
30 
31 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
32 
33 /* The definition of _GL_ARG_NONNULL is copied here.  */
34 
35 /* The definition of _GL_WARN_ON_USE is copied here.  */
36 
37 
38 #if @GNULIB_ICONV@
39 # if @REPLACE_ICONV_OPEN@
40 /* An iconv_open wrapper that supports the IANA standardized encoding names
41    ("ISO-8859-1" etc.) as far as possible.  */
42 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
43 #   define iconv_open rpl_iconv_open
44 #  endif
45 _GL_FUNCDECL_RPL (iconv_open, iconv_t,
46                   (const char *tocode, const char *fromcode)
47                   _GL_ARG_NONNULL ((1, 2)));
48 _GL_CXXALIAS_RPL (iconv_open, iconv_t,
49                   (const char *tocode, const char *fromcode));
50 # else
51 _GL_CXXALIAS_SYS (iconv_open, iconv_t,
52                   (const char *tocode, const char *fromcode));
53 # endif
54 _GL_CXXALIASWARN (iconv_open);
55 #elif defined GNULIB_POSIXCHECK
56 # undef iconv_open
57 # if HAVE_RAW_DECL_ICONV_OPEN
58 _GL_WARN_ON_USE (iconv_open, "iconv_open is not working correctly everywhere - "
59                  "use gnulib module iconv for portability");
60 # endif
61 #endif
62 
63 #if @REPLACE_ICONV_UTF@
64 /* Special constants for supporting UTF-{16,32}{BE,LE} encodings.
65    Not public.  */
66 # define _ICONV_UTF8_UTF16BE (iconv_t)(-161)
67 # define _ICONV_UTF8_UTF16LE (iconv_t)(-162)
68 # define _ICONV_UTF8_UTF32BE (iconv_t)(-163)
69 # define _ICONV_UTF8_UTF32LE (iconv_t)(-164)
70 # define _ICONV_UTF16BE_UTF8 (iconv_t)(-165)
71 # define _ICONV_UTF16LE_UTF8 (iconv_t)(-166)
72 # define _ICONV_UTF32BE_UTF8 (iconv_t)(-167)
73 # define _ICONV_UTF32LE_UTF8 (iconv_t)(-168)
74 #endif
75 
76 #if @GNULIB_ICONV@
77 # if @REPLACE_ICONV@
78 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
79 #   define iconv rpl_iconv
80 #  endif
81 _GL_FUNCDECL_RPL (iconv, size_t,
82                   (iconv_t cd,
83                    @ICONV_CONST@ char **restrict inbuf,
84                    size_t *restrict inbytesleft,
85                    char **restrict outbuf, size_t *restrict outbytesleft));
86 _GL_CXXALIAS_RPL (iconv, size_t,
87                   (iconv_t cd,
88                    @ICONV_CONST@ char **restrict inbuf,
89                    size_t *restrict inbytesleft,
90                    char **restrict outbuf, size_t *restrict outbytesleft));
91 # else
92 /* Need to cast, because on some versions of Solaris, ICONV_CONST does
93    not have the right value for C++.  */
94 _GL_CXXALIAS_SYS_CAST (iconv, size_t,
95                        (iconv_t cd,
96                         @ICONV_CONST@ char **restrict inbuf,
97                         size_t *restrict inbytesleft,
98                         char **restrict outbuf, size_t *restrict outbytesleft));
99 # endif
100 _GL_CXXALIASWARN (iconv);
101 # ifndef ICONV_CONST
102 #  define ICONV_CONST @ICONV_CONST@
103 # endif
104 #elif defined GNULIB_POSIXCHECK
105 # undef iconv
106 # if HAVE_RAW_DECL_ICONV
107 _GL_WARN_ON_USE (iconv, "iconv is not working correctly everywhere - "
108                  "use gnulib module iconv for portability");
109 # endif
110 #endif
111 
112 #if @GNULIB_ICONV@
113 # if @REPLACE_ICONV@
114 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
115 #   define iconv_close rpl_iconv_close
116 #  endif
117 _GL_FUNCDECL_RPL (iconv_close, int, (iconv_t cd));
118 _GL_CXXALIAS_RPL (iconv_close, int, (iconv_t cd));
119 # else
120 _GL_CXXALIAS_SYS (iconv_close, int, (iconv_t cd));
121 # endif
122 _GL_CXXALIASWARN (iconv_close);
123 #endif
124 
125 
126 #endif /* _@GUARD_PREFIX@_ICONV_H */
127 #endif /* _@GUARD_PREFIX@_ICONV_H */
128