(ignore_errors_p): Define.
[kopensolaris-gnu/glibc.git] / iconv / loop.c
1 /* Conversion loop frame work.
2    Copyright (C) 1998, 1999, 2000 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4    Contributed by Ulrich Drepper <drepper@cygnus.com>, 1998.
5
6    The GNU C Library is free software; you can redistribute it and/or
7    modify it under the terms of the GNU Library General Public License as
8    published by the Free Software Foundation; either version 2 of the
9    License, or (at your option) any later version.
10
11    The GNU C Library is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14    Library General Public License for more details.
15
16    You should have received a copy of the GNU Library General Public
17    License along with the GNU C Library; see the file COPYING.LIB.  If not,
18    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19    Boston, MA 02111-1307, USA.  */
20
21 /* This file provides a frame for the reader loop in all conversion modules.
22    The actual code must (of course) be provided in the actual module source
23    code but certain actions can be written down generically, with some
24    customization options which are these:
25
26      MIN_NEEDED_INPUT   minimal number of input bytes needed for the next
27                         conversion.
28      MIN_NEEDED_OUTPUT  minimal number of bytes produced by the next round
29                         of conversion.
30
31      MAX_NEEDED_INPUT   you guess it, this is the maximal number of input
32                         bytes needed.  It defaults to MIN_NEEDED_INPUT
33      MAX_NEEDED_OUTPUT  likewise for output bytes.
34
35      LOOPFCT            name of the function created.  If not specified
36                         the name is `loop' but this prevents the use
37                         of multiple functions in the same file.
38
39      BODY               this is supposed to expand to the body of the loop.
40                         The user must provide this.
41
42      EXTRA_LOOP_DECLS   extra arguments passed from converion loop call.
43
44      INIT_PARAMS        code to define and initialize variables from params.
45      UPDATE_PARAMS      code to store result in params.
46 */
47
48 #include <assert.h>
49 #include <endian.h>
50 #include <gconv.h>
51 #include <stdint.h>
52 #include <string.h>
53 #include <wchar.h>
54 #include <sys/param.h>          /* For MIN.  */
55 #define __need_size_t
56 #include <stddef.h>
57
58
59 /* We have to provide support for machines which are not able to handled
60    unaligned memory accesses.  Some of the character encodings have
61    representations with a fixed width of 2 or 4 bytes.  But if we cannot
62    access unaligned memory we still have to read byte-wise.  */
63 #undef FCTNAME2
64 #if defined _STRING_ARCH_unaligned || !defined DEFINE_UNALIGNED
65 /* We can handle unaligned memory access.  */
66 # define get16(addr) *((uint16_t *) (addr))
67 # define get32(addr) *((uint32_t *) (addr))
68
69 /* We need no special support for writing values either.  */
70 # define put16(addr, val) *((uint16_t *) (addr)) = (val)
71 # define put32(addr, val) *((uint32_t *) (addr)) = (val)
72
73 # define FCTNAME2(name) name
74 #else
75 /* Distinguish between big endian and little endian.  */
76 # if __BYTE_ORDER == __LITTLE_ENDIAN
77 #  define get16(addr) \
78      (((__const unsigned char *) (addr))[1] << 8                              \
79       | ((__const unsigned char *) (addr))[0])
80 #  define get32(addr) \
81      (((((__const unsigned char *) (addr))[3] << 8                            \
82         | ((__const unsigned char *) (addr))[2]) << 8                         \
83        | ((__const unsigned char *) (addr))[1]) << 8                          \
84       | ((__const unsigned char *) (addr))[0])
85
86 #  define put16(addr, val) \
87      ({ uint16_t __val = (val);                                               \
88         ((unsigned char *) (addr))[0] = __val;                                \
89         ((unsigned char *) (addr))[1] = __val >> 8;                           \
90         (void) 0; })
91 #  define put32(addr, val) \
92      ({ uint32_t __val = (val);                                               \
93         ((unsigned char *) (addr))[0] = __val;                                \
94         __val >>= 8;                                                          \
95         ((unsigned char *) (addr))[1] = __val;                                \
96         __val >>= 8;                                                          \
97         ((unsigned char *) (addr))[2] = __val;                                \
98         __val >>= 8;                                                          \
99         ((unsigned char *) (addr))[3] = __val;                                \
100         (void) 0; })
101 # else
102 #  define get16(addr) \
103      (((__const unsigned char *) (addr))[0] << 8                              \
104       | ((__const unsigned char *) (addr))[1])
105 #  define get32(addr) \
106      (((((__const unsigned char *) (addr))[0] << 8                            \
107         | ((__const unsigned char *) (addr))[1]) << 8                         \
108        | ((__const unsigned char *) (addr))[2]) << 8                          \
109       | ((__const unsigned char *) (addr))[3])
110
111 #  define put16(addr, val) \
112      ({ uint16_t __val = (val);                                               \
113         ((unsigned char *) (addr))[1] = __val;                                \
114         ((unsigned char *) (addr))[2] = __val >> 8;                           \
115         (void) 0; })
116 #  define put32(addr, val) \
117      ({ uint32_t __val = (val);                                               \
118         ((unsigned char *) (addr))[3] = __val;                                \
119         __val >>= 8;                                                          \
120         ((unsigned char *) (addr))[2] = __val;                                \
121         __val >>= 8;                                                          \
122         ((unsigned char *) (addr))[1] = __val;                                \
123         __val >>= 8;                                                          \
124         ((unsigned char *) (addr))[0] = __val;                                \
125         (void) 0; })
126 # endif
127
128 # define FCTNAME2(name) name##_unaligned
129 #endif
130 #define FCTNAME(name) FCTNAME2(name)
131
132
133 /* We need at least one byte for the next round.  */
134 #ifndef MIN_NEEDED_INPUT
135 # error "MIN_NEEDED_INPUT definition missing"
136 #endif
137
138 /* Let's see how many bytes we produce.  */
139 #ifndef MAX_NEEDED_INPUT
140 # define MAX_NEEDED_INPUT       MIN_NEEDED_INPUT
141 #endif
142
143 /* We produce at least one byte in the next round.  */
144 #ifndef MIN_NEEDED_OUTPUT
145 # error "MIN_NEEDED_OUTPUT definition missing"
146 #endif
147
148 /* Let's see how many bytes we produce.  */
149 #ifndef MAX_NEEDED_OUTPUT
150 # define MAX_NEEDED_OUTPUT      MIN_NEEDED_OUTPUT
151 #endif
152
153 /* Default name for the function.  */
154 #ifndef LOOPFCT
155 # define LOOPFCT                loop
156 #endif
157
158 /* Make sure we have a loop body.  */
159 #ifndef BODY
160 # error "Definition of BODY missing for function" LOOPFCT
161 #endif
162
163
164 /* If no arguments have to passed to the loop function define the macro
165    as empty.  */
166 #ifndef EXTRA_LOOP_DECLS
167 # define EXTRA_LOOP_DECLS
168 #endif
169
170
171 /* To make it easier for the writers of the modules, we define a macro
172    to test whether we have to ignore errors.  */
173 #define ignore_errors_p() (flags & __GCONV_IGNORE_ERRORS)
174
175
176 /* The function returns the status, as defined in gconv.h.  */
177 static inline int
178 FCTNAME (LOOPFCT) (const unsigned char **inptrp, const unsigned char *inend,
179                    unsigned char **outptrp, unsigned char *outend,
180                    mbstate_t *state, int flags, void *data, size_t *converted
181                    EXTRA_LOOP_DECLS)
182 {
183   int result = __GCONV_OK;
184   const unsigned char *inptr = *inptrp;
185   unsigned char *outptr = *outptrp;
186
187   /* We run one loop where we avoid checks for underflow/overflow of the
188      buffers to speed up the conversion a bit.  */
189   size_t min_in_rounds = (inend - inptr) / MAX_NEEDED_INPUT;
190   size_t min_out_rounds = (outend - outptr) / MAX_NEEDED_OUTPUT;
191   size_t min_rounds = MIN (min_in_rounds, min_out_rounds);
192
193 #ifdef INIT_PARAMS
194   INIT_PARAMS;
195 #endif
196
197 #undef NEED_LENGTH_TEST
198 #define NEED_LENGTH_TEST        0
199   while (min_rounds-- > 0)
200     {
201       /* Here comes the body the user provides.  It can stop with RESULT
202          set to GCONV_INCOMPLETE_INPUT (if the size of the input characters
203          vary in size), GCONV_ILLEGAL_INPUT, or GCONV_FULL_OUTPUT (if the
204          output characters vary in size.  */
205       BODY
206     }
207
208   if (result == __GCONV_OK)
209     {
210 #if MIN_NEEDED_INPUT == MAX_NEEDED_INPUT \
211     && MIN_NEEDED_OUTPUT == MAX_NEEDED_OUTPUT
212       /* We don't need to start another loop since we were able to determine
213          the maximal number of characters to copy in advance.  What remains
214          to be determined is the status.  */
215       if (inptr == inend)
216         /* No more input.  */
217         result = __GCONV_EMPTY_INPUT;
218       else if ((MIN_NEEDED_OUTPUT != 1 && outptr + MIN_NEEDED_OUTPUT > outend)
219                || (MIN_NEEDED_OUTPUT == 1 && outptr >= outend))
220         /* Overflow in the output buffer.  */
221         result = __GCONV_FULL_OUTPUT;
222       else
223         /* We have something left in the input buffer.  */
224         result = __GCONV_INCOMPLETE_INPUT;
225 #else
226       result = __GCONV_EMPTY_INPUT;
227
228 # undef NEED_LENGTH_TEST
229 # define NEED_LENGTH_TEST       1
230       while (inptr != inend)
231         {
232           /* `if' cases for MIN_NEEDED_OUTPUT ==/!= 1 is made to help the
233              compiler generating better code.  It will optimized away
234              since MIN_NEEDED_OUTPUT is always a constant.  */
235           if ((MIN_NEEDED_OUTPUT != 1 && outptr + MIN_NEEDED_OUTPUT > outend)
236               || (MIN_NEEDED_OUTPUT == 1 && outptr >= outend))
237             {
238               /* Overflow in the output buffer.  */
239               result = __GCONV_FULL_OUTPUT;
240               break;
241             }
242           if (MIN_NEEDED_INPUT > 1 && inptr + MIN_NEEDED_INPUT > inend)
243             {
244               /* We don't have enough input for another complete input
245                  character.  */
246               result = __GCONV_INCOMPLETE_INPUT;
247               break;
248             }
249
250           /* Here comes the body the user provides.  It can stop with
251              RESULT set to GCONV_INCOMPLETE_INPUT (if the size of the
252              input characters vary in size), GCONV_ILLEGAL_INPUT, or
253              GCONV_FULL_OUTPUT (if the output characters vary in size).  */
254           BODY
255         }
256 #endif  /* Input and output charset are not both fixed width.  */
257     }
258
259   /* Update the pointers pointed to by the parameters.  */
260   *inptrp = inptr;
261   *outptrp = outptr;
262 #ifdef UPDATE_PARAMS
263   UPDATE_PARAMS;
264 #endif
265
266   return result;
267 }
268
269
270 /* Include the file a second time to define the function to define the
271    function to handle unaligned access.  */
272 #if !defined DEFINE_UNALIGNED && !defined _STRING_ARCH_unaligned \
273     && MIN_NEEDED_FROM != 1 && MAX_NEEDED_FROM % MIN_NEEDED_FROM == 0 \
274     && MIN_NEEDED_TO != 1 && MAX_NEEDED_TO % MIN_NEEDED_TO == 0
275 # undef get16
276 # undef get32
277 # undef put16
278 # undef put32
279 # undef unaligned
280
281 # define DEFINE_UNALIGNED
282 # include "loop.c"
283 # undef DEFINE_UNALIGNED
284 #endif
285
286
287 #if MAX_NEEDED_INPUT > 1
288 # define SINGLE(fct) SINGLE2 (fct)
289 # define SINGLE2(fct) fct##_single
290 static inline int
291 SINGLE(LOOPFCT) (const unsigned char **inptrp, const unsigned char *inend,
292                  unsigned char **outptrp, unsigned char *outend,
293                  mbstate_t *state, int flags, void *data, size_t *converted
294                  EXTRA_LOOP_DECLS)
295 {
296   int result = __GCONV_OK;
297   unsigned char bytebuf[MAX_NEEDED_INPUT];
298   const unsigned char *inptr = *inptrp;
299   unsigned char *outptr = *outptrp;
300   size_t inlen;
301
302 #ifdef INIT_PARAMS
303   INIT_PARAMS;
304 #endif
305
306 #ifdef UNPACK_BYTES
307   UNPACK_BYTES
308 #else
309   /* Add the bytes from the state to the input buffer.  */
310   for (inlen = 0; inlen < (state->__count & 7); ++ inlen)
311     bytebuf[inlen] = state->__value.__wchb[inlen];
312 #endif
313
314   /* Are there enough bytes in the input buffer?  */
315   if (__builtin_expect (inptr + (MIN_NEEDED_INPUT - inlen) > inend, 0))
316     {
317       *inptrp = inend;
318 #ifdef STORE_REST
319       inptr = bytebuf;
320       inptrp = &inptr;
321       inend = &bytebuf[inlen];
322
323       STORE_REST
324 #else
325       /* We don't have enough input for another complete input
326          character.  */
327       while (inptr < inend)
328         state->__value.__wchb[inlen++] = *inptr++;
329 #endif
330
331       return __GCONV_INCOMPLETE_INPUT;
332     }
333
334   /* Enough space in output buffer.  */
335   if ((MIN_NEEDED_OUTPUT != 1 && outptr + MIN_NEEDED_OUTPUT > outend)
336       || (MIN_NEEDED_OUTPUT == 1 && outptr >= outend))
337     /* Overflow in the output buffer.  */
338     return __GCONV_FULL_OUTPUT;
339
340   /*  Now add characters from the normal input buffer.  */
341   do
342     bytebuf[inlen++] = *inptr++;
343   while (inlen < MAX_NEEDED_INPUT && inptr < inend);
344
345   inptr = bytebuf;
346   inend = &bytebuf[inlen];
347 #undef NEED_LENGTH_TEST
348 #define NEED_LENGTH_TEST        1
349   do
350     {
351       BODY
352     }
353   while (0);
354
355   /* Now we either have produced an output character and consumed all the
356      bytes from the state and at least one more, or the character is still
357      incomplete, or we have some other error (like illegal input character,
358      no space in output buffer).  */
359   if (inptr != bytebuf)
360     {
361       /* We found a new character.  */
362       assert (inptr - bytebuf > (state->__count & 7));
363
364       *inptrp += inptr - bytebuf - (state->__count & 7);
365       *outptrp = outptr;
366
367       result = __GCONV_OK;
368
369       /* Clear the state buffer.  */
370       state->__count &= ~7;
371     }
372   else if (result == __GCONV_INCOMPLETE_INPUT)
373     {
374       /* This can only happen if we have less than MAX_NEEDED_INPUT bytes
375          available.  */
376       assert (inend != &bytebuf[MAX_NEEDED_INPUT]);
377
378       *inptrp += inend - bytebuf - (state->__count & 7);
379 #ifdef STORE_REST
380       inptrp = &inptr;
381
382       STORE_REST
383 #else
384       /* We don't have enough input for another complete input
385          character.  */
386       while (inptr < inend)
387         state->__value.__wchb[inlen++] = *inptr++;
388 #endif
389     }
390
391   return result;
392 }
393 # undef SINGLE
394 # undef SINGLE2
395 #endif
396
397
398 /* We remove the macro definitions so that we can include this file again
399    for the definition of another function.  */
400 #undef MIN_NEEDED_INPUT
401 #undef MAX_NEEDED_INPUT
402 #undef MIN_NEEDED_OUTPUT
403 #undef MAX_NEEDED_OUTPUT
404 #undef LOOPFCT
405 #undef BODY
406 #undef LOOPFCT
407 #undef EXTRA_LOOP_DECLS
408 #undef INIT_PARAMS
409 #undef UPDATE_PARAMS
410 #undef get16
411 #undef get32
412 #undef put16
413 #undef put32
414 #undef unaligned
415 #undef UNPACK_BYTES