.\" Copyright (c) Free Software Foundation, Inc.
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 3 of
.\" the License, or (at your option) any later version.
.\"
.\" References consulted:
.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"   POSIX 2001 draft6
.\"
.TH ICONV 1  "December 15, 2024" "GNU"
.SH "نام (NAME)"
iconv \- تبدیل مجموعه نویسه‌ها و کدگذاری متن
.SH "خلاصه دستور (SYNOPSIS)"
.nf
iconv [\fIOPTION\fP...] [\fB\-f\fP \fIencoding\fP] [\fB\-t\fP \fIencoding\fP] [\fIinputfile\fP ...]
iconv \fB\-l\fP
.fi
.SH "توضیحات (DESCRIPTION)"
برنامه
\fBiconv\fP
متن را از یک کدگذاری به کدگذاری دیگری تبدیل می‌کند.
به طور دقیق‌تر، متن را
\fBاز\fP
کدگذاری مشخص‌شده برای گزینه
\fB\-f\fP
\fBبه\fP
کدگذاری مشخص‌شده برای گزینه
\fB\-t\fP
تبدیل می‌نماید. در صورت مشخص نشدن، هر یک از این کدگذاری‌ها به طور پیش‌فرض بر روی کدگذاری محلی (locale) فعلی سیستم تنظیم می‌شوند. تمام فایل‌های
\fIinputfile\fP
به ترتیب خوانده شده و تبدیل می‌گردند؛ اگر هیچ
\fIinputfile\fP
داده نشود، ورودی استاندارد استفاده می‌شود. متن تبدیل‌شده در خروجی استاندارد چاپ خواهد شد.
.PP
کدگذاری‌های مجاز به سیستم وابسته هستند. برای پیاده‌سازی libiconv، این کدگذاری‌ها در صفحه راهنمای
.BR iconv_open (3)
فهرست شده‌اند.
.PP
گزینه‌های کنترل‌کننده قالب ورودی و خروجی:
.TP
\fB\-f\fP \fIencoding\fP, \fB\-\-from\-code=\fP\fIencoding\fP
کدگذاری ورودی را مشخص می‌کند.
.TP
\fB\-t\fP \fIencoding\fP, \fB\-\-to\-code=\fP\fIencoding\fP
کدگذاری خروجی را مشخص می‌کند.
.PP
گزینه‌های کنترل‌کننده مشکلات تبدیل:
.TP
\fB\-c\fP
هنگامی که این گزینه داده شود، نویسه‌هایی که قابل تبدیل نیستند به جای ایجاد خطای تبدیل، نادیده گرفته شده و حذف می‌شوند.
.TP
\fB\-\-unicode\-subst=\fP\fIformatstring\fP
هنگامی که این گزینه داده شود، نویسه‌های یونیکدی که در کدگذاری مقصد قابل نمایش نیستند با یک رشته جایگزین که بر اساس
\fIformatstring\fP
داده‌شده و روی مقدار کد پوینت یونیکد اعمال می‌شود، جایگزین می‌گردند.
\fIformatstring\fP
باید یک رشته قالب‌بندی هم‌فرمت با دستور
.I printf
یا تابع
.I printf()
باشد که یا هیچ آرگومانی نمی‌پذیرد یا دقیقاً یک آرگومان عدد صحیح بدون علامت دریافت می‌کند.
.TP
\fB\-\-byte\-subst=\fP\fIformatstring\fP
هنگامی که این گزینه داده شود، بایت‌های نامعتبر در کدگذاری مبدأ با یک رشته جایگزین که بر اساس
\fIformatstring\fP
داده‌شده و روی مقدار بایت اعمال می‌شود، جایگزین می‌گردند.
\fIformatstring\fP
باید یک رشته قالب‌بندی هم‌فرمت با دستور
.I printf
یا تابع
.I printf()
باشد که یا هیچ آرگومانی نمی‌پذیرد یا دقیقاً یک آرگومان عدد صحیح بدون علامت دریافت می‌کند.
.TP
\fB\-\-widechar\-subst=\fP\fIformatstring\fP
هنگامی که این گزینه داده شود، نویسه‌های عریض نامعتبر در کدگذاری مبدأ با یک رشته جایگزین که بر اساس
\fIformatstring\fP
داده‌شده و روی مقدار بایت اعمال می‌شود، جایگزین می‌گردند.
\fIformatstring\fP
باید یک رشته قالب‌بندی هم‌فرمت با دستور
.I printf
یا تابع
.I printf()
باشد که یا هیچ آرگومانی نمی‌پذیرد یا دقیقاً یک آرگومان عدد صحیح بدون علامت دریافت می‌کند.
.PP
گزینه‌های کنترل‌کننده خروجی خطا:
.TP
\fB\-s\fP, \fB\-\-silent\fP
هنگامی که این گزینه داده شود، پیام‌های خطای مربوط به نویسه‌های نامعتبر یا غیرقابل تبدیل چاپ نمی‌شوند، اما متن تبدیل‌شده واقعی تغییری نمی‌کند.
.PP
دستور
\fBiconv \-l\fP
یا
\fBiconv \-\-list\fP
نام کدگذاری‌های پشتیبانی‌شده را در قالبی وابسته به سیستم فهرست می‌کند. برای پیاده‌سازی libiconv، نام‌ها با حروف بزرگ و با فاصله از یکدیگر چاپ می‌شوند، و نام‌های مستعار یک کدگذاری در همان سطر مربوط به خود کدگذاری آورده می‌شوند.
.SH "محیط (ENVIRONMENT)"
تبدیل از یا به کدگذاری‌های EBCDIC را می‌توان به روشی خاص سفارشی کرد:
اگر متغیر محیطی
\fBICONV_EBCDIC_ZOS_UNIX\fP
روی یک مقدار غیرخالی تنظیم شده باشد، نویسه خط جدید EBCDIC با مقدار 0x15 به جای NEL به LF نگاشت خواهد شد.
.SH "مثال‌ها (EXAMPLES)"
.TP
\fBiconv \-f ISO\-8859\-1 \-t UTF\-8\fP
ورودی را از کدگذاری قدیمی اروپای غربی ISO\-8859\-1 به یونیکد تبدیل می‌کند.
.PP
.nf
\fBiconv \-f KOI8\-R \-\-byte\-subst="<0x%x>"\fP
\fB                \-\-unicode\-subst="<U+%04X>"\fP
.fi
.RS
ورودی را از کدگذاری قدیمی روسی KOI8\-R به کدگذاری محلی تبدیل می‌کند و به جای بایت‌های نامعتبر و نویسه‌های معتبر ولی غیرقابل تبدیل، نمایش هگزادسیمال در داخل براکت‌های زاویه‌دار قرار می‌دهد.
.RE
.TP
\fBiconv \-\-list\fP
کدگذاری‌های پشتیبانی‌شده را فهرست می‌کند.
.SH "سازگاری با استانداردها (CONFORMING TO)"
POSIX:2024
.SH "همچنین ببینید (SEE ALSO)"
.BR iconv_open (3),
.BR locale (7)