iconv_canonicalize(3)

iconv_canonicalize3

Resolving character encoding names to canonical form

Usage

#include <iconv.h>

const char *

iconv_canonicalize(const char *name);

Library

Standard C Library (libc, -lc)

Overview

The iconv_canonicalize() function resolves the character encoding name specified by the name argument to its canonical form.

Return values

Upon successful completion iconv_canonicalize(), returns the canonical name of the given encoding. If the specified name is already a canonical name, the same value is returned. If the specified name is not an existing character encoding name, NULL is returned.

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_canonicalize 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 ⟨[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.