__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

Check Out this Related Man Page

ICONVLIST(3)						   BSD Library Functions Manual 					      ICONVLIST(3)

NAME

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

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <iconv.h>

     void
     iconvlist(int (*do_one)(unsigned int *count, const char * const *names, void *arg), void *arg);

DESCRIPTION

     The iconvlist() function obtains a list of character encodings that are supported by the iconv(3) call.  The do_one() callback function will
     be called, where the count argument will be set to the number of the encoding names found, the names argument will be the list of the sup-
     ported encoding names and the arg argument will be the arg argument of the iconvlist() function.  This argument can be used to interchange
     custom data between the caller of iconvlist() and the callback function.

     If an error occurs, names will be NULL when calling do_one().

SEE ALSO

     __iconv_free_list(3), __iconv_get_list(3), iconv(3)

STANDARDS

     The iconvlist function is a non-standard extension, which appeared in the GNU implementation and was adopted in FreeBSD 9.0 for compatibil-
     ity's sake.

AUTHORS

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

BSD
								 October 20, 2009							       BSD

Linux and UNIX Man Pages

__iconv_get_list(3) [freebsd man page]

Check Out this Related Man Page