__iconv_get_list(3)

__iconv_get_list3

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

Usage

#include <iconv.h>

int

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

void

__iconv_free_list(char **names, size_t count);

Library

Standard C Library (libc, -lc)

Overview

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.

Releases

30 releases since FreeBSD 10.0-RELEASE; the text changed 16 times.

  1. 10.0
  2. 10.1
  3. 10.2
  4. 10.3
  5. 10.4
  6. 11.0
  7. 11.1
  8. 11.2
  9. 11.3
  10. 11.4
  11. 12.0
  12. 12.1
  13. 12.2
  14. 12.3
  15. 12.4
  16. 13.0–13.2
  17. 13.3–16.0

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 ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.