| 1 | .\" Copyright (c) Bruno Haible <bruno@clisp.org> |
|---|
| 2 | .\" |
|---|
| 3 | .\" This is free documentation; you can redistribute it and/or |
|---|
| 4 | .\" modify it under the terms of the GNU General Public License as |
|---|
| 5 | .\" published by the Free Software Foundation; either version 2 of |
|---|
| 6 | .\" the License, or (at your option) any later version. |
|---|
| 7 | .\" |
|---|
| 8 | .\" References consulted: |
|---|
| 9 | .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html |
|---|
| 10 | .\" POSIX 2001 draft6 |
|---|
| 11 | .\" |
|---|
| 12 | .TH ICONV 1 "January 13, 2002" "GNU" "Linux Programmer's Manual" |
|---|
| 13 | .SH NAME |
|---|
| 14 | iconv \- character set conversion |
|---|
| 15 | .SH SYNOPSIS |
|---|
| 16 | .nf |
|---|
| 17 | iconv [\fB-c\fP] [\fB-s\fP] [\fB-f\fP \fIencoding\fP] [\fB-t\fP \fIencoding\fP] [\fIinputfile\fP ...] |
|---|
| 18 | iconv \fB-l\fP |
|---|
| 19 | .fi |
|---|
| 20 | .SH DESCRIPTION |
|---|
| 21 | The \fBiconv\fP program converts text from one encoding to another encoding. |
|---|
| 22 | More precisely, it converts \fBfrom\fP the encoding given for the \fB-f\fP |
|---|
| 23 | option \fBto\fP the encoding given for the \fB-t\fP option. Either of these |
|---|
| 24 | encodings defaults to the encoding of the current locale. All the |
|---|
| 25 | \fIinputfile\fPs are read and converted in turn; if no \fIinputfile\fP is |
|---|
| 26 | given, the standard input is used. The converted text is printed to standard |
|---|
| 27 | output. |
|---|
| 28 | .PP |
|---|
| 29 | When option \fB-c\fP is given, characters that cannot be converted are |
|---|
| 30 | silently discarded, instead of leading to a conversion error. |
|---|
| 31 | .PP |
|---|
| 32 | When option \fB-s\fP is given, error messages about invalid or unconvertible |
|---|
| 33 | characters are omitted, but the actual converted text is unaffected. |
|---|
| 34 | .PP |
|---|
| 35 | The encodings permitted are system dependent. For the libiconv implementation, |
|---|
| 36 | they are listed in the iconv_open(3) manual page. |
|---|
| 37 | .PP |
|---|
| 38 | The \fBiconv -l\fP command lists the names of the supported encodings, in a |
|---|
| 39 | system dependent format. For the libiconv implementation, the names are |
|---|
| 40 | printed in upper case, separated by whitespace, and alias names of an encoding |
|---|
| 41 | are listed on the same line as the encoding itself. |
|---|
| 42 | .SH "SEE ALSO" |
|---|
| 43 | .BR iconv_open "(3), " locale (7) |
|---|
