---

---

---

001: /* Copyright (C) 1997-1999, 2000-2002, 2007, 2011 Free Software Foundation, Inc.
002:    This file is part of the GNU C Library.
003: 
004:    The GNU C Library is free software; you can redistribute it and/or
005:    modify it under the terms of the GNU Lesser General Public
006:    License as published by the Free Software Foundation; either
007:    version 2.1 of the License, or (at your option) any later version.
008: 
009:    The GNU C Library is distributed in the hope that it will be useful,
010:    but WITHOUT ANY WARRANTY; without even the implied warranty of
011:    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
012:    Lesser General Public License for more details.
013: 
014:    You should have received a copy of the GNU Lesser General Public
015:    License along with the GNU C Library; if not, write to the Free
016:    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
017:    02111-1307 USA.  */
018: 
019: /* This header provides no interface for a user to the internals of
020:    the gconv implementation in the libc.  Therefore there is no use
021:    for these definitions beside for writing additional gconv modules.  */
022: 
023: #ifndef _GCONV_H
024: #define _GCONV_H        1
025: 
026: #include <features.h>
027: #define __need_mbstate_t
028: #define __need_wint_t
029: #include <wchar.h>
030: #define __need_size_t
031: #define __need_wchar_t
032: #include <stddef.h>
033: 
034: /* ISO 10646 value used to signal invalid value.  */
035: #define __UNKNOWN_10646_CHAR    ((wchar_t) 0xfffd)
036: 
037: /* Error codes for gconv functions.  */
038: enum
039: {
040:   __GCONV_OK = 0,
041:   __GCONV_NOCONV,
042:   __GCONV_NODB,
043:   __GCONV_NOMEM,
044: 
045:   __GCONV_EMPTY_INPUT,
046:   __GCONV_FULL_OUTPUT,
047:   __GCONV_ILLEGAL_INPUT,
048:   __GCONV_INCOMPLETE_INPUT,
049: 
050:   __GCONV_ILLEGAL_DESCRIPTOR,
051:   __GCONV_INTERNAL_ERROR
052: };
053: 
054: 
055: /* Flags the `__gconv_open' function can set.  */
056: enum
057: {
058:   __GCONV_IS_LAST = 0x0001,
059:   __GCONV_IGNORE_ERRORS = 0x0002,
060:   __GCONV_SWAP = 0x0004
061: };
062: 
063: 
064: /* Forward declarations.  */
065: struct __gconv_step;
066: struct __gconv_step_data;
067: struct __gconv_loaded_object;
068: struct __gconv_trans_data;
069: 
070: 
071: /* Type of a conversion function.  */
072: typedef int (*__gconv_fct) (struct __gconv_step *, struct __gconv_step_data *,
073:                             __const unsigned char **, __const unsigned char *,
074:                             unsigned char **, size_t *, int, int);
075: 
076: /* Type of a specialized conversion function for a single byte to INTERNAL.  */
077: typedef wint_t (*__gconv_btowc_fct) (struct __gconv_step *, unsigned char);
078: 
079: /* Constructor and destructor for local data for conversion step.  */
080: typedef int (*__gconv_init_fct) (struct __gconv_step *);
081: typedef void (*__gconv_end_fct) (struct __gconv_step *);
082: 
083: 
084: /* Type of a transliteration/transscription function.  */
085: typedef int (*__gconv_trans_fct) (struct __gconv_step *,
086:                                   struct __gconv_step_data *, void *,
087:                                   __const unsigned char *,
088:                                   __const unsigned char **,
089:                                   __const unsigned char *, unsigned char **,
090:                                   size_t *);
091: 
092: /* Function to call to provide transliteration module with context.  */
093: typedef int (*__gconv_trans_context_fct) (void *, __const unsigned char *,
094:                                           __const unsigned char *,
095:                                           unsigned char *, unsigned char *);
096: 
097: /* Function to query module about supported encoded character sets.  */
098: typedef int (*__gconv_trans_query_fct) (__const char *, __const char ***,
099:                                         size_t *);
100: 
101: /* Constructor and destructor for local data for transliteration.  */
102: typedef int (*__gconv_trans_init_fct) (void **, const char *);
103: typedef void (*__gconv_trans_end_fct) (void *);
104: 
105: struct __gconv_trans_data
106: {
107:   /* Transliteration/Transscription function.  */
108:   __gconv_trans_fct __trans_fct;
109:   __gconv_trans_context_fct __trans_context_fct;
110:   __gconv_trans_end_fct __trans_end_fct;
111:   void *__data;
112:   struct __gconv_trans_data *__next;
113: };
114: 
115: 
116: /* Description of a conversion step.  */
117: struct __gconv_step
118: {
119:   struct __gconv_loaded_object *__shlib_handle;
120:   __const char *__modname;
121: 
122:   int __counter;
123: 
124:   char *__from_name;
125:   char *__to_name;
126: 
127:   __gconv_fct __fct;
128:   __gconv_btowc_fct __btowc_fct;
129:   __gconv_init_fct __init_fct;
130:   __gconv_end_fct __end_fct;
131: 
132:   /* Information about the number of bytes needed or produced in this
133:      step.  This helps optimizing the buffer sizes.  */
134:   int __min_needed_from;
135:   int __max_needed_from;
136:   int __min_needed_to;
137:   int __max_needed_to;
138: 
139:   /* Flag whether this is a stateful encoding or not.  */
140:   int __stateful;
141: 
142:   void *__data;         /* Pointer to step-local data.  */
143: };
144: 
145: /* Additional data for steps in use of conversion descriptor.  This is
146:    allocated by the `init' function.  */
147: struct __gconv_step_data
148: {
149:   unsigned char *__outbuf;    /* Output buffer for this step.  */
150:   unsigned char *__outbufend; /* Address of first byte after the output
151:                                  buffer.  */
152: 
153:   /* Is this the last module in the chain.  */
154:   int __flags;
155: 
156:   /* Counter for number of invocations of the module function for this
157:      descriptor.  */
158:   int __invocation_counter;
159: 
160:   /* Flag whether this is an internal use of the module (in the mb*towc*
161:      and wc*tomb* functions) or regular with iconv(3).  */
162:   int __internal_use;
163: 
164:   __mbstate_t *__statep;
165:   __mbstate_t __state;  /* This element must not be used directly by
166:                            any module; always use STATEP!  */
167: 
168:   /* Transliteration information.  */
169:   struct __gconv_trans_data *__trans;
170: };
171: 
172: 
173: /* Combine conversion step description with data.  */
174: typedef struct __gconv_info
175: {
176:   size_t __nsteps;
177:   struct __gconv_step *__steps;
178:   __extension__ struct __gconv_step_data __data __flexarr;
179: } *__gconv_t;
180: 
181: #endif /* gconv.h */
182: 

---

---

---