Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ICONV(1)		FreeBSD	General	Commands Manual		      ICONV(1)

NAME
     iconv -- codeset conversion utility

SYNOPSIS
     iconv [-cs] -f from_name -t to_name [file ...]
     iconv -f from_name	[-cs] [-t to_name] [file ...]
     iconv -t to_name [-cs] [-f	from_name] [file ...]
     iconv -l

DESCRIPTION
     The iconv utility converts	the codeset of file (or	from standard input if
     no	file is	specified) from	codeset	from_name to codeset to_name and out-
     puts the converted	text on	standard output.

     The following options are available:

     -c	   Prevent output of any invalid characters.  By default, iconv	out-
	   puts	an "invalid character" specified by the	to_name	codeset	when
	   it encounts a character which is valid in the from_name codeset but
	   does	not have a corresponding character in the to_name codeset.

     -f	   Specifies the source	codeset	name as	from_name.

     -l	   Lists available codeset names.  Note	that not all combinations of
	   from_name and to_name are valid.

     -s	   Silent.  By default,	iconv outputs the number of "invalid
	   characters" to standard error if they exist.	 This option prevents
	   this	behaviour.

     -t	   Specifies the destination codeset name as to_name.

EXIT STATUS
     The iconv utility exits 0 on success, and >0 if an	error occurs.

EXAMPLES
     Convert file.txt from IBM273 to UTF-8 and save the	result to
     converted.txt:

	   iconv -f IBM273 -t UTF-8 file.txt > converted.txt

SEE ALSO
     mkcsmapper(1), mkesdb(1), iconv(3)

STANDARDS
     iconv conform to IEEE Std 1003.1-2008 ("POSIX.1").

HISTORY
     iconv first appeared in NetBSD 2.0, and made its appearance in
     FreeBSD 9.0.

FreeBSD	13.0		       October 22, 2009			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | SEE ALSO | STANDARDS | HISTORY

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=iconv&manpath=FreeBSD+13.2-RELEASE+and+Ports>

home | help