Where Online Learning is simpler!

The C and C++ Include Header Files

/usr/include/iconv.h


$ cat -n /usr/include/iconv.h

     1	/* Copyright (C) 1997-2024 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 */