1 /* Copyright (C) 1997-2022 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 Lesser General Public 6 License as published by the Free Software Foundation; either 7 version 2.1 of the 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 Lesser General Public License for more details. 13 14 You should have received a copy of the GNU Lesser General Public 15 License along with the GNU C Library; if not, see 16 <https://www.gnu.org/licenses/>. */ 17 18 #ifndef _ICONV_H 19 #define _ICONV_H 1 20 21 #include <features.h> 22 #define __need_size_t 23 #include <stddef.h> 24 25 26 __BEGIN_DECLS 27 28 /* Identifier for conversion method from one codeset to another. */ 29 typedef void *iconv_t; 30 31 32 /* Free resources allocated for descriptor CD for code conversion. 33 34 This function is a possible cancellation point and therefore not 35 marked with __THROW. */ 36 extern int iconv_close (iconv_t __cd); 37 38 /* Allocate descriptor for code conversion from codeset FROMCODE to 39 codeset TOCODE. 40 41 This function is a possible cancellation point and therefore not 42 marked with __THROW. */ 43 extern iconv_t iconv_open (const char *__tocode, const char *__fromcode) 44 __attribute_malloc__ __attr_dealloc (iconv_close, 1); 45 46 /* Convert at most *INBYTESLEFT bytes from *INBUF according to the 47 code conversion algorithm specified by CD and place up to 48 *OUTBYTESLEFT bytes in buffer at *OUTBUF. */ 49 extern size_t iconv (iconv_t __cd, char **__restrict __inbuf, 50 size_t *__restrict __inbytesleft, 51 char **__restrict __outbuf, 52 size_t *__restrict __outbytesleft); 53 54 __END_DECLS 55 56 #endif /* iconv.h */ 57