(__gconv_trans_context_fct): Remove two parameters.
[kopensolaris-gnu/glibc.git] / iconv / gconv.h
1 /* Copyright (C) 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
2    This file is part of the GNU C Library.
3
4    The GNU C Library is free software; you can redistribute it and/or
5    modify it under the terms of the GNU Library General Public License as
6    published by the Free Software Foundation; either version 2 of the
7    License, or (at your option) any later version.
8
9    The GNU C Library is distributed in the hope that it will be useful,
10    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 C Library; see the file COPYING.LIB.  If not,
16    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17    Boston, MA 02111-1307, USA.  */
18
19 /* This header provides no interface for a user to the internals of
20    the gconv implementation in the libc.  Therefore there is no use
21    for these definitions beside for writing additional gconv modules.  */
22
23 #ifndef _GCONV_H
24 #define _GCONV_H        1
25
26 #include <features.h>
27 #define __need_mbstate_t
28 #include <wchar.h>
29 #define __need_size_t
30 #include <stddef.h>
31
32 /* ISO 10646 value used to signal invalid value.  */
33 #define __UNKNOWN_10646_CHAR    ((wchar_t) 0xfffd)
34
35 /* Error codes for gconv functions.  */
36 enum
37 {
38   __GCONV_OK = 0,
39   __GCONV_NOCONV,
40   __GCONV_NODB,
41   __GCONV_NOMEM,
42
43   __GCONV_EMPTY_INPUT,
44   __GCONV_FULL_OUTPUT,
45   __GCONV_ILLEGAL_INPUT,
46   __GCONV_INCOMPLETE_INPUT,
47
48   __GCONV_ILLEGAL_DESCRIPTOR,
49   __GCONV_INTERNAL_ERROR
50 };
51
52
53 /* Flags the `__gconv_open' function can set.  */
54 enum
55 {
56   __GCONV_IS_LAST = 0x0001,
57   __GCONV_IGNORE_ERRORS = 0x0002
58 };
59
60
61 /* Forward declarations.  */
62 struct __gconv_step;
63 struct __gconv_step_data;
64 struct __gconv_loaded_object;
65 struct __gconv_trans_data;
66
67
68 /* Type of a conversion function.  */
69 typedef int (*__gconv_fct) (struct __gconv_step *, struct __gconv_step_data *,
70                             __const unsigned char **, __const unsigned char *,
71                             unsigned char *, size_t *, int, int);
72
73 /* Constructor and destructor for local data for conversion step.  */
74 typedef int (*__gconv_init_fct) (struct __gconv_step *);
75 typedef void (*__gconv_end_fct) (struct __gconv_step *);
76
77
78 /* Type of a transliteration/transscription function.  */
79 typedef int (*__gconv_trans_fct) (struct __gconv_step *step,
80                                   struct __gconv_step_data *step_data,
81                                   __const unsigned char *,
82                                   __const unsigned char **,
83                                   __const unsigned char *, unsigned char *,
84                                   unsigned char **, unsigned char *, size_t *);
85
86 /* Function to call to provide transliteration module with context.  */
87 typedef int (*__gconv_trans_context_fct) (struct __gconv_trans_data *data,
88                                           __const unsigned char *,
89                                           __const unsigned char *,
90                                           unsigned char *, unsigned char *);
91
92 /* Function to query module about supported encoded character sets.  */
93 typedef int (*__gconv_trans_query_fct) (__const char **, size_t *);
94
95 /* Constructor and destructor for local data for transliteration.  */
96 typedef int (*__gconv_trans_init_fct) (void **, const char *);
97 typedef void (*__gconv_trans_end_fct) (void *);
98
99 struct __gconv_trans_data
100 {
101   /* Transliteration/Transscription function.  */
102   __gconv_trans_fct __trans_fct;
103   __gconv_trans_context_fct __trans_context_fct;
104   __gconv_trans_end_fct __trans_end_fct;
105   void *__data;
106 };
107
108
109 /* Description of a conversion step.  */
110 struct __gconv_step
111 {
112   struct __gconv_loaded_object *__shlib_handle;
113   __const char *__modname;
114
115   int __counter;
116
117   __const char *__from_name;
118   __const char *__to_name;
119
120   __gconv_fct __fct;
121   __gconv_init_fct __init_fct;
122   __gconv_end_fct __end_fct;
123
124   /* Information about the number of bytes needed or produced in this
125      step.  This helps optimizing the buffer sizes.  */
126   int __min_needed_from;
127   int __max_needed_from;
128   int __min_needed_to;
129   int __max_needed_to;
130
131   /* Flag whether this is a stateful encoding or not.  */
132   int __stateful;
133
134   void *__data;         /* Pointer to step-local data.  */
135 };
136
137 /* Additional data for steps in use of conversion descriptor.  This is
138    allocated by the `init' function.  */
139 struct __gconv_step_data
140 {
141   unsigned char *__outbuf;    /* Output buffer for this step.  */
142   unsigned char *__outbufend; /* Address of first byte after the output
143                                  buffer.  */
144
145   /* Is this the last module in the chain.  */
146   int __flags;
147
148   /* Counter for number of invocations of the module function for this
149      descriptor.  */
150   int __invocation_counter;
151
152   /* Flag whether this is an internal use of the module (in the mb*towc*
153      and wc*tomb* functions) or regular with iconv(3).  */
154   int __internal_use;
155
156   __mbstate_t *__statep;
157   __mbstate_t __state;  /* This element must not be used directly by
158                            any module; always use STATEP!  */
159
160   /* Transliteration information.  */
161   struct __gconv_trans_data __trans;
162 };
163
164
165 /* Combine conversion step description with data.  */
166 typedef struct __gconv_info
167 {
168   size_t __nsteps;
169   struct __gconv_step *__steps;
170   __extension__ struct __gconv_step_data __data[0];
171 } *__gconv_t;
172
173 #endif /* gconv.h */