1 | /* Copyright (C) 1999-2003 Free Software Foundation, Inc.
|
---|
2 | This file is part of the GNU LIBICONV Library.
|
---|
3 |
|
---|
4 | The GNU LIBICONV Library is free software; you can redistribute it
|
---|
5 | and/or modify it under the terms of the GNU Library General Public
|
---|
6 | License as published by the Free Software Foundation; either version 2
|
---|
7 | of the License, or (at your option) any later version.
|
---|
8 |
|
---|
9 | The GNU LIBICONV Library is distributed in the hope that it will be
|
---|
10 | useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
11 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
---|
12 | Library General Public License for more details.
|
---|
13 |
|
---|
14 | You should have received a copy of the GNU Library General Public
|
---|
15 | License along with the GNU LIBICONV Library; see the file COPYING.LIB.
|
---|
16 | If not, write to the Free Software Foundation, Inc., 59 Temple Place -
|
---|
17 | Suite 330, Boston, MA 02111-1307, USA. */
|
---|
18 |
|
---|
19 | /* When installed, this file is called "iconv.h". */
|
---|
20 |
|
---|
21 | #ifndef _LIBICONV_H
|
---|
22 | #define _LIBICONV_H
|
---|
23 |
|
---|
24 | #define _LIBICONV_VERSION 0x0109 /* version number: (major<<8) + minor */
|
---|
25 | extern int _libiconv_version; /* Likewise */
|
---|
26 |
|
---|
27 | /* We would like to #include any system header file which could define
|
---|
28 | iconv_t, 1. in order to eliminate the risk that the user gets compilation
|
---|
29 | errors because some other system header file includes /usr/include/iconv.h
|
---|
30 | which defines iconv_t or declares iconv after this file, 2. when compiling
|
---|
31 | for LIBICONV_PLUG, we need the proper iconv_t type in order to produce
|
---|
32 | binary compatible code.
|
---|
33 | But gcc's #include_next is not portable. Thus, once libiconv's iconv.h
|
---|
34 | has been installed in /usr/local/include, there is no way any more to
|
---|
35 | include the original /usr/include/iconv.h. We simply have to get away
|
---|
36 | without it.
|
---|
37 | Ad 1. The risk that a system header file does
|
---|
38 | #include "iconv.h" or #include_next "iconv.h"
|
---|
39 | is small. They all do #include <iconv.h>.
|
---|
40 | Ad 2. The iconv_t type is a pointer type in all cases I have seen. (It
|
---|
41 | has to be a scalar type because (iconv_t)(-1) is a possible return value
|
---|
42 | from iconv_open().) */
|
---|
43 |
|
---|
44 | /* Define iconv_t ourselves. */
|
---|
45 | #undef iconv_t
|
---|
46 | #define iconv_t libiconv_t
|
---|
47 | typedef void* iconv_t;
|
---|
48 |
|
---|
49 | /* Get size_t declaration. */
|
---|
50 | #include <stddef.h>
|
---|
51 |
|
---|
52 | /* Get errno declaration and values. */
|
---|
53 | #include <errno.h>
|
---|
54 | /* Some systems, like SunOS 4, don't have EILSEQ. Some systems, like BSD/OS,
|
---|
55 | have EILSEQ in a different header. On these systems, define EILSEQ
|
---|
56 | ourselves. */
|
---|
57 | #ifndef EILSEQ
|
---|
58 | #define EILSEQ @EILSEQ@
|
---|
59 | #endif
|
---|
60 |
|
---|
61 |
|
---|
62 | #ifdef __cplusplus
|
---|
63 | extern "C" {
|
---|
64 | #endif
|
---|
65 |
|
---|
66 |
|
---|
67 | /* Allocates descriptor for code conversion from encoding `fromcode' to
|
---|
68 | encoding `tocode'. */
|
---|
69 | #ifndef LIBICONV_PLUG
|
---|
70 | #define iconv_open libiconv_open
|
---|
71 | #endif
|
---|
72 | extern iconv_t iconv_open (const char* tocode, const char* fromcode);
|
---|
73 |
|
---|
74 | /* Converts, using conversion descriptor `cd', at most `*inbytesleft' bytes
|
---|
75 | starting at `*inbuf', writing at most `*outbytesleft' bytes starting at
|
---|
76 | `*outbuf'.
|
---|
77 | Decrements `*inbytesleft' and increments `*inbuf' by the same amount.
|
---|
78 | Decrements `*outbytesleft' and increments `*outbuf' by the same amount. */
|
---|
79 | #ifndef LIBICONV_PLUG
|
---|
80 | #define iconv libiconv
|
---|
81 | #endif
|
---|
82 | extern size_t iconv (iconv_t cd, const char* * inbuf, size_t *inbytesleft, char* * outbuf, size_t *outbytesleft);
|
---|
83 |
|
---|
84 | /* Frees resources allocated for conversion descriptor `cd'. */
|
---|
85 | #ifndef LIBICONV_PLUG
|
---|
86 | #define iconv_close libiconv_close
|
---|
87 | #endif
|
---|
88 | extern int iconv_close (iconv_t cd);
|
---|
89 |
|
---|
90 |
|
---|
91 | #ifndef LIBICONV_PLUG
|
---|
92 |
|
---|
93 | /* Nonstandard extensions. */
|
---|
94 |
|
---|
95 | /* Control of attributes. */
|
---|
96 | #define iconvctl libiconvctl
|
---|
97 | extern int iconvctl (iconv_t cd, int request, void* argument);
|
---|
98 |
|
---|
99 | /* Requests for iconvctl. */
|
---|
100 | #define ICONV_TRIVIALP 0 /* int *argument */
|
---|
101 | #define ICONV_GET_TRANSLITERATE 1 /* int *argument */
|
---|
102 | #define ICONV_SET_TRANSLITERATE 2 /* const int *argument */
|
---|
103 | #define ICONV_GET_DISCARD_ILSEQ 3 /* int *argument */
|
---|
104 | #define ICONV_SET_DISCARD_ILSEQ 4 /* const int *argument */
|
---|
105 |
|
---|
106 | /* Listing of locale independent encodings. */
|
---|
107 | #define iconvlist libiconvlist
|
---|
108 | extern void iconvlist (int (*do_one) (unsigned int namescount,
|
---|
109 | const char * const * names,
|
---|
110 | void* data),
|
---|
111 | void* data);
|
---|
112 |
|
---|
113 | /* Support for relocatable packages. */
|
---|
114 |
|
---|
115 | /* Sets the original and the current installation prefix of the package.
|
---|
116 | Relocation simply replaces a pathname starting with the original prefix
|
---|
117 | by the corresponding pathname with the current prefix instead. Both
|
---|
118 | prefixes should be directory names without trailing slash (i.e. use ""
|
---|
119 | instead of "/"). */
|
---|
120 | extern void libiconv_set_relocation_prefix (const char *orig_prefix,
|
---|
121 | const char *curr_prefix);
|
---|
122 |
|
---|
123 | #endif
|
---|
124 |
|
---|
125 |
|
---|
126 | #ifdef __cplusplus
|
---|
127 | }
|
---|
128 | #endif
|
---|
129 |
|
---|
130 |
|
---|
131 | #endif /* _LIBICONV_H */
|
---|