1 /* Copyright (C) 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
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.
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.
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. */
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. */
27 #define __need_mbstate_t
32 /* ISO 10646 value used to signal invalid value. */
33 #define __UNKNOWN_10646_CHAR ((wchar_t) 0xfffd)
35 /* Error codes for gconv functions. */
45 __GCONV_ILLEGAL_INPUT
,
46 __GCONV_INCOMPLETE_INPUT
,
48 __GCONV_ILLEGAL_DESCRIPTOR
,
49 __GCONV_INTERNAL_ERROR
53 /* Flags the `__gconv_open' function can set. */
56 __GCONV_IS_LAST
= 0x0001,
57 __GCONV_IGNORE_ERRORS
= 0x0002
61 /* Forward declarations. */
63 struct __gconv_step_data
;
64 struct __gconv_loaded_object
;
65 struct __gconv_trans_data
;
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);
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
*);
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 *);
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 *);
92 /* Function to query module about supported encoded character sets. */
93 typedef int (*__gconv_trans_query_fct
) (__const
char **, size_t *);
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 *);
99 struct __gconv_trans_data
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
;
109 /* Description of a conversion step. */
112 struct __gconv_loaded_object
*__shlib_handle
;
113 __const
char *__modname
;
117 __const
char *__from_name
;
118 __const
char *__to_name
;
121 __gconv_init_fct __init_fct
;
122 __gconv_end_fct __end_fct
;
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
;
131 /* Flag whether this is a stateful encoding or not. */
134 void *__data
; /* Pointer to step-local data. */
137 /* Additional data for steps in use of conversion descriptor. This is
138 allocated by the `init' function. */
139 struct __gconv_step_data
141 unsigned char *__outbuf
; /* Output buffer for this step. */
142 unsigned char *__outbufend
; /* Address of first byte after the output
145 /* Is this the last module in the chain. */
148 /* Counter for number of invocations of the module function for this
150 int __invocation_counter
;
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). */
156 __mbstate_t
*__statep
;
157 __mbstate_t __state
; /* This element must not be used directly by
158 any module; always use STATEP! */
160 /* Transliteration information. */
161 struct __gconv_trans_data __trans
;
165 /* Combine conversion step description with data. */
166 typedef struct __gconv_info
169 struct __gconv_step
*__steps
;
170 __extension__
struct __gconv_step_data __data
[0];