__iconv_get_list(3) [freebsd man page]

__ICONV_GET_LIST(3)					   BSD Library Functions Manual 				       __ICONV_GET_LIST(3)

NAME

     __iconv_get_list __iconv_free_list -- retrieving a list of character encodings supported by iconv(3)

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <iconv.h>

     int
     __iconv_get_list(char ***names, size_t count, bool paired);

     void
     __iconv_free_list(char **names, size_t count);

DESCRIPTION

     The __iconv_get_list() function obtains a list of character encodings that are supported by the iconv(3) call.  The list of the encoding
     names will be stored in names and the number of the entries is stored in count.  If the paired variable is true, the list will be arranged
     into canonical/alias name pairs.

     The __iconv_free_list() function is to free the allocated memory during the call of __iconv_get_list().

RETURN VALUES

     Upon successful completion __iconv_get_list() returns 0 and set the names and count arguments.  Otherwise, -1 is returned and errno is set to
     indicate the error.

SEE ALSO

     iconv(3), iconvlist(3)

STANDARDS

     The __iconv_get_list and __iconv_free_list functions are non-standard interfaces, which appeared in the implementation of the Citrus Project.
     The iconv implementation of the Citrus Project was adopted in FreeBSD 9.0.

AUTHORS

     This manual page was written by Gabor Kovesdan <gabor@FreeBSD.org>.

BSD
								 October 20, 2009							       BSD

ICONV(1)						    BSD General Commands Manual 						  ICONV(1)

NAME

     iconv -- codeset conversion utility

SYNOPSIS

     iconv [-cs] -f from_name -t to_name [file ...]
     iconv -f from_name [-cs] [-t to_name] [file ...]
     iconv -t to_name [-cs] [-f from_name] [file ...]
     iconv -l

DESCRIPTION

     The iconv utility converts the codeset of file (or from standard input if no file is specified) from codeset from_name to codeset to_name and
     outputs the converted text on standard output.

     The following options are available:

     -c    Prevent output of any invalid characters.  By default, iconv outputs an ``invalid character'' specified by the to_name codeset when it
	   encounts a character which is valid in the from_name codeset but does not have a corresponding character in the to_name codeset.

     -f    Specifies the source codeset name as from_name.

     -l    Lists available codeset names.  Note that not all combinations of from_name and to_name are valid.

     -s    Silent.  By default, iconv outputs the number of ``invalid characters'' to standard error if they exist.  This option prevents this be-
	   haviour.

     -t    Specifies the destination codeset name as to_name.

EXIT STATUS

     The iconv utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

     mkcsmapper(1), mkesdb(1), iconv(3)

STANDARDS

     iconv conform to IEEE Std 1003.1-2008 (``POSIX.1'').

HISTORY

     iconv first appeared in NetBSD 2.0, and made its appearance in FreeBSD 9.0.

BSD
								 October 22, 2009							       BSD