نام (NAME)

iconv - تبدیل مجموعه نویسه‌ها و کدگذاری متن

خلاصه دستور (SYNOPSIS)

iconv [OPTION...] [-f encoding] [-t encoding] [inputfile ...]
iconv -l

توضیحات (DESCRIPTION)

برنامه iconv متن را از یک کدگذاری به کدگذاری دیگری تبدیل می‌کند. به طور دقیق‌تر، متن را از کدگذاری مشخص‌شده برای گزینه -f به کدگذاری مشخص‌شده برای گزینه -t تبدیل می‌نماید. در صورت مشخص نشدن، هر یک از این کدگذاری‌ها به طور پیش‌فرض بر روی کدگذاری محلی (locale) فعلی سیستم تنظیم می‌شوند. تمام فایل‌های inputfile به ترتیب خوانده شده و تبدیل می‌گردند؛ اگر هیچ inputfile داده نشود، ورودی استاندارد استفاده می‌شود. متن تبدیل‌شده در خروجی استاندارد چاپ خواهد شد.

کدگذاری‌های مجاز به سیستم وابسته هستند. برای پیاده‌سازی libiconv، این کدگذاری‌ها در صفحه راهنمای iconv_open(3) فهرست شده‌اند.

گزینه‌های کنترل‌کننده قالب ورودی و خروجی:

-f encoding, --from-code=encoding: کدگذاری ورودی را مشخص می‌کند.
-t encoding, --to-code=encoding: کدگذاری خروجی را مشخص می‌کند.

گزینه‌های کنترل‌کننده مشکلات تبدیل:

-c: هنگامی که این گزینه داده شود، نویسه‌هایی که قابل تبدیل نیستند به جای ایجاد خطای تبدیل، نادیده گرفته شده و حذف می‌شوند.
--unicode-subst=formatstring: هنگامی که این گزینه داده شود، نویسه‌های یونیکدی که در کدگذاری مقصد قابل نمایش نیستند با یک رشته جایگزین که بر اساس formatstring داده‌شده و روی مقدار کد پوینت یونیکد اعمال می‌شود، جایگزین می‌گردند. formatstring باید یک رشته قالب‌بندی هم‌فرمت با دستور printf یا تابع printf() باشد که یا هیچ آرگومانی نمی‌پذیرد یا دقیقاً یک آرگومان عدد صحیح بدون علامت دریافت می‌کند.
--byte-subst=formatstring: هنگامی که این گزینه داده شود، بایت‌های نامعتبر در کدگذاری مبدأ با یک رشته جایگزین که بر اساس formatstring داده‌شده و روی مقدار بایت اعمال می‌شود، جایگزین می‌گردند. formatstring باید یک رشته قالب‌بندی هم‌فرمت با دستور printf یا تابع printf() باشد که یا هیچ آرگومانی نمی‌پذیرد یا دقیقاً یک آرگومان عدد صحیح بدون علامت دریافت می‌کند.
--widechar-subst=formatstring: هنگامی که این گزینه داده شود، نویسه‌های عریض نامعتبر در کدگذاری مبدأ با یک رشته جایگزین که بر اساس formatstring داده‌شده و روی مقدار بایت اعمال می‌شود، جایگزین می‌گردند. formatstring باید یک رشته قالب‌بندی هم‌فرمت با دستور printf یا تابع printf() باشد که یا هیچ آرگومانی نمی‌پذیرد یا دقیقاً یک آرگومان عدد صحیح بدون علامت دریافت می‌کند.

گزینه‌های کنترل‌کننده خروجی خطا:

-s, --silent: هنگامی که این گزینه داده شود، پیام‌های خطای مربوط به نویسه‌های نامعتبر یا غیرقابل تبدیل چاپ نمی‌شوند، اما متن تبدیل‌شده واقعی تغییری نمی‌کند.

دستور iconv -l یا iconv --list نام کدگذاری‌های پشتیبانی‌شده را در قالبی وابسته به سیستم فهرست می‌کند. برای پیاده‌سازی libiconv، نام‌ها با حروف بزرگ و با فاصله از یکدیگر چاپ می‌شوند، و نام‌های مستعار یک کدگذاری در همان سطر مربوط به خود کدگذاری آورده می‌شوند.

محیط (ENVIRONMENT)

تبدیل از یا به کدگذاری‌های EBCDIC را می‌توان به روشی خاص سفارشی کرد: اگر متغیر محیطی ICONV_EBCDIC_ZOS_UNIX روی یک مقدار غیرخالی تنظیم شده باشد، نویسه خط جدید EBCDIC با مقدار 0x15 به جای NEL به LF نگاشت خواهد شد.

مثال‌ها (EXAMPLES)

iconv -f ISO-8859-1 -t UTF-8: ورودی را از کدگذاری قدیمی اروپای غربی ISO-8859-1 به یونیکد تبدیل می‌کند.

iconv -f KOI8-R --byte-subst="<0x%x>"
                --unicode-subst="<U+%04X>"

ورودی را از کدگذاری قدیمی روسی KOI8-R به کدگذاری محلی تبدیل می‌کند و به جای بایت‌های نامعتبر و نویسه‌های معتبر ولی غیرقابل تبدیل، نمایش هگزادسیمال در داخل براکت‌های زاویه‌دار قرار می‌دهد.

iconv --list: کدگذاری‌های پشتیبانی‌شده را فهرست می‌کند.

سازگاری با استانداردها (CONFORMING TO)

POSIX:2024

همچنین ببینید (SEE ALSO)

iconv_open(3), locale(7)