(install-locales): Allow specifying charset in locale name but omit it in
[kopensolaris-gnu/glibc.git] / iconv / iconv.h
1 /* Copyright (C) 1997, 1998 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 #ifndef _ICONV_H
20 #define _ICONV_H        1
21
22 #include <features.h>
23 #define __need_size_t
24 #include <stddef.h>
25
26
27 __BEGIN_DECLS
28
29 /* Identifier for conversion method from one codeset to another.  */
30 typedef void *iconv_t;
31
32
33 /* Allocate descriptor for code conversion from codeset FROMCODE to
34    codeset TOCODE.  */
35 extern iconv_t iconv_open __P ((__const char *__tocode,
36                                 __const char *__fromcode));
37
38 /* Convert at most *INBYTESLEFT bytes from *INBUF according to the
39    code conversion algorithm specified by CD and place up to
40    *OUTBYTESLEFT bytes in buffer at *OUTBUF.  */
41 extern size_t iconv __P ((iconv_t cd,
42                           __const char **__restrict __inbuf,
43                           size_t *__restrict __inbytesleft,
44                           char **__restrict __outbuf,
45                           size_t *__restrict __outbytesleft));
46
47 /* Free resources allocated for descriptor CD for code conversion.  */
48 extern int iconv_close __P ((iconv_t __cd));
49
50 __END_DECLS
51
52 #endif /* iconv.h */