(install-locales): Allow specifying charset in locale name but omit it in
[kopensolaris-gnu/glibc.git] / iconv / gconv.h
1 /* Copyright (C) 1997, 1998, 1999 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 #include <wchar.h>
28 #define __need_size_t
29 #include <stddef.h>
30
31 /* ISO 10646 value used to signal invalid value.  */
32 #define UNKNOWN_10646_CHAR      ((wchar_t) 0xfffd)
33
34 /* Error codes for gconv functions.  */
35 enum
36 {
37   GCONV_OK = 0,
38   GCONV_NOCONV,
39   GCONV_NODB,
40   GCONV_NOMEM,
41
42   GCONV_EMPTY_INPUT,
43   GCONV_FULL_OUTPUT,
44   GCONV_ILLEGAL_INPUT,
45   GCONV_INCOMPLETE_INPUT,
46
47   GCONV_ILLEGAL_DESCRIPTOR,
48   GCONV_INTERNAL_ERROR
49 };
50
51
52 /* Forward declarations.  */
53 struct gconv_step;
54 struct gconv_step_data;
55 struct gconv_loaded_object;
56
57
58 /* Type of a conversion function.  */
59 typedef int (*gconv_fct) __PMT ((struct gconv_step *,
60                                  struct gconv_step_data *,
61                                  __const unsigned char **,
62                                  __const unsigned char *, size_t *, int));
63
64 /* Constructor and destructor for local data for conversion step.  */
65 typedef int (*gconv_init_fct) __PMT ((struct gconv_step *));
66 typedef void (*gconv_end_fct) __PMT ((struct gconv_step *));
67
68
69 /* Description of a conversion step.  */
70 struct gconv_step
71 {
72   struct gconv_loaded_object *shlib_handle;
73   __const char *modname;
74
75   int counter;
76
77   __const char *from_name;
78   __const char *to_name;
79
80   gconv_fct fct;
81   gconv_init_fct init_fct;
82   gconv_end_fct end_fct;
83
84   /* Information about the number of bytes needed or produced in this
85      step.  This helps optimizing the buffer sizes.  */
86   int min_needed_from;
87   int max_needed_from;
88   int min_needed_to;
89   int max_needed_to;
90
91   /* Flag whether this is a stateful encoding or not.  */
92   int stateful;
93
94   void *data;           /* Pointer to step-local data.  */
95 };
96
97 /* Additional data for steps in use of conversion descriptor.  This is
98    allocated by the `init' function.  */
99 struct gconv_step_data
100 {
101   unsigned char *outbuf;    /* Output buffer for this step.  */
102   unsigned char *outbufend; /* Address of first byte after the output buffer.*/
103
104   /* Is this the last module in the chain.  */
105   int is_last;
106
107   /* Counter for number of invocations of the module function for this
108      descriptor.  */
109   int invocation_counter;
110
111   /* Flag whether this is an internal use of the module (in the mb*towc*
112      and wc*tomb* functions) or regular with iconv(3).  */
113   int internal_use;
114
115   mbstate_t *statep;
116   mbstate_t __state;    /* This element should not be used directly by
117                            any module; always use STATEP!  */
118 };
119
120
121 /* Combine conversion step description with data.  */
122 typedef struct gconv_info
123 {
124   size_t nsteps;
125   struct gconv_step *steps;
126   struct gconv_step_data data[0];
127 } *gconv_t;
128
129 #endif /* gconv.h */