---
name: "iconv_canonicalize"
section: "3"
platform: "macos"
package: "libiconv"
version: "115.120.2"
release: "macOS 26.5"
platforms: ["freebsd", "macos"]
url: "https://new.carta.tech/iconv_canonicalize"
---

# iconv\_canonicalize(3)

resolving character encoding names to canonical form

## NAME

**iconv\_canonicalize** – resolving character encoding names to canonical form

## LIBRARY

Standard C Library (libc, -lc)

## SYNOPSIS

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

*const* *char* *\**\

**iconv\_canonicalize**(*const char \*name*);

## DESCRIPTION

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.

## SEE ALSO

[iconv(3)](/iconv/3.md)

## 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 ⟨*gabor@FreeBSD.org*⟩.