iconv_canonicalize
—
resolving character encoding names to canonical form
Standard C Library (libc, -lc)
#include <iconv.h>
const char *
iconv_canonicalize
(const
char *name);
The iconv_canonicalize
() function resolves the character
encoding name specified by the name argument to its
canonical form.
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.
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.