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

FreeBSD Manual Pages

  
 
  

home | help
ICONV(1)		     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 outputs
     the converted text on standard output.

     The following options are available:

     -c    Prevent output of any invalid characters.  By default, iconv  outputs
	   an  "invalid  character" specified by the to_name codeset when it en-
	   counts 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  behav-
	   iour.

     -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 ports 15.1		October 22, 2009			ICONV(1)

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

home | help