---
name: "iconvlist"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd", "macos"]
url: "https://new.carta.tech/iconvlist"
---

# iconvlist(3)

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

## NAME

**iconvlist** – retrieving a list of character encodings supported by [iconv(3)](/iconv/3.md)

## LIBRARY

Standard C Library (libc, -lc)

## SYNOPSIS

**#include \<iconv.h\>**

*void*\

**iconvlist**(*int \*do\_oneunsigned 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)](/iconv/3.md) 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 supported 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_free_list/3.md), [\_\_iconv\_get\_list(3)](/__iconv_get_list/3.md), [iconv(3)](/iconv/3.md)

## STANDARDS

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

## AUTHORS

This manual page was written by Gabor Kovesdan ⟨*gabor@FreeBSD.org*⟩.