Back to index

glibc  2.9
iconv.h
Go to the documentation of this file.
00001 /* Copyright (C) 1997, 1998, 1999, 2000, 2003 Free Software Foundation, Inc.
00002    This file is part of the GNU C Library.
00003 
00004    The GNU C Library is free software; you can redistribute it and/or
00005    modify it under the terms of the GNU Lesser General Public
00006    License as published by the Free Software Foundation; either
00007    version 2.1 of the License, or (at your option) any later version.
00008 
00009    The GNU C Library is distributed in the hope that it will be useful,
00010    but WITHOUT ANY WARRANTY; without even the implied warranty of
00011    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00012    Lesser General Public License for more details.
00013 
00014    You should have received a copy of the GNU Lesser General Public
00015    License along with the GNU C Library; if not, write to the Free
00016    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
00017    02111-1307 USA.  */
00018 
00019 #ifndef _ICONV_H
00020 #define _ICONV_H     1
00021 
00022 #include <features.h>
00023 #define __need_size_t
00024 #include <stddef.h>
00025 
00026 
00027 __BEGIN_DECLS
00028 
00029 /* Identifier for conversion method from one codeset to another.  */
00030 typedef void *iconv_t;
00031 
00032 
00033 /* Allocate descriptor for code conversion from codeset FROMCODE to
00034    codeset TOCODE.
00035 
00036    This function is a possible cancellation points and therefore not
00037    marked with __THROW.  */
00038 extern iconv_t iconv_open (__const char *__tocode, __const char *__fromcode);
00039 
00040 /* Convert at most *INBYTESLEFT bytes from *INBUF according to the
00041    code conversion algorithm specified by CD and place up to
00042    *OUTBYTESLEFT bytes in buffer at *OUTBUF.  */
00043 extern size_t iconv (iconv_t __cd, char **__restrict __inbuf,
00044                    size_t *__restrict __inbytesleft,
00045                    char **__restrict __outbuf,
00046                    size_t *__restrict __outbytesleft);
00047 
00048 /* Free resources allocated for descriptor CD for code conversion.
00049 
00050    This function is a possible cancellation points and therefore not
00051    marked with __THROW.  */
00052 extern int iconv_close (iconv_t __cd);
00053 
00054 __END_DECLS
00055 
00056 #endif /* iconv.h */